ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

How to use SWTCHKEY in ACF2?

book

Article ID: 225154

calendar_today

Updated On:

Products

ACF2 - z/OS

Issue/Introduction

SWTCHKEY is needed to issue F ACF2,SWITCH(DDSN) command. 

Environment

Release : 16.0

Component : CA ACF2 for z/OS

Resolution

The following ACF commands can be used to check if SWTCHKEY is set up in GSO OPTS record: 

SET CONTROL(GSO)
LIST OPTS

The SWTCHTOD value (date/time of last SWTCHKEY update) shows:
- a non-zero value SWTCHTOD(06/11/21-17:17), if SWTCHKEY is setup
- zero value SWTCHTOD(00/00/00-00:00), if SWTCHKEY is not setup

The SWTCHKEY field is encrypted when stored in the database and is never displayed.

If the SWTCHKEY is not set up or it's lost, the sample JCL is shown below to add a new SWTCHKEY using ACFBATCH job. 

//ACFBATCH EXEC PGM=ACFBATCH
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
SET CONTROL(GSO)
CHANGE OPTS SWTCHKEY(abcdefgh) = > choose key here
F ACF2,REFRESH(OPTS)
/*

 

Additional Information

Here is more information on switchkey from doc:

SWTCHKEY(key)
Sets the key for the F ACF2,SWITCH (DDSN list name) command. This is an 8-byte character field which can contain letters, numbers, and any of the following character symbols in parentheses ($, #, @, !, %, &, -, =, :, _, ^, ., ?, |). Note that although lowercase letters are allowed when specifying the key, each letter is uppercase before being stored. The console prompts for this key when issuing the F ACF2,SWITCH (DDSN list name) command. This field is encrypted when stored in the database and is never displayed.