How SYSID is used in the F ACF2,REFRESH(OPTS),SYSID(xxxx) to select GSO OPTS record in the INFOSTG database?

Products

• ACF2 - z/OS

Issue/Introduction

How SYSID is used  in the F ACF2,REFRESH(GSO recordid),SYSID(sysid) to select a GSO recordid in the INFOSTG database? A site has several GSO OPTS records stored under several SYSIDs, some are explicit SYSIDs such as SYSA, SYSB or SYSC and other are masked such as SYS*, SY** or ****. 

Environment

Release : 16.0

Component : CA ACF2 for z/OS

Resolution

The example shows how the SYSID is used in relationship to the 'F ACF2,REFRESH(OPTS),SYSID(sysid)' when there are multiple GSO OPTS records stored in the ACF2 INFOSTG database with both specific SYSIDs and masked SYSIDs.

The following should be considered.

1. The TSO, ACF, 'SHOW SYSTEMS' will show the 'CURRENT SYSID' also referred to as the 'active' SYSID.
2. ACF2 uses the active SYSID string as the SYSID for all records created or updated during a session if the user does not specify a SYSID when he establishes an ACF command setting, such as CONTROL.
3. ACF2 uses the 'active' SYSID string as the SYSID for all 'F ACF2,REFRESH(record)' commands when no SYSID is specified, when searching for the GSO records.
4. If the 'F ACF2,REFRESH(record)' command is issued with the SYSID(sysid) parameter, the sysid will override the 'active' SYSID that is used when searching for the GSO records stored under SYSIDs.
5. The SYSID parameter specified in the 'F ACF2,REFRESH(OPTS),SYSID(sysid)' cannot be masked, so '-' and '*' characters are treated as literals.
6. Note the 'F ACF2,REFRESH(OPTS),SYSID(sysid)' command does not change the 'active' SYSID that displays as the 'CURRENT SYSID' in the 'SHOW SYSTEMS' command.
7. The operator can change the SYSID anytime after ACF2 startup using the SETSYS operand of the z/OS MODIFY command. For example, the active SYSID becomes TEST if the operator enters the following command: 'F ACF2,SETSYS(TEST)'.

For example:

Three GSO OPTS records exist in the ACF2 INFOSTG database under different SYSIDs, two SYSID are masked.

Type SYSID  Record
GSO  MES* / OPTS
GSO  PROD / OPTS
GSO  **** / OPTS

The TSO, ACF, 'SHOW SYSTEMS' command displays:
CURRENT SYSID=MESB       STARTUP SYSID=MESB       BUILT ACCVT=MESB     

Example 1
Command 'F ACF2,REFRESH(OPTS)' is issued.
Since no SYSID was specified on the command, the 'active' SYSID MESB will be used to search for GSO OPTS records. The 'GSO  MES* / OPTS' will be used because it is the most specific SYSID that matches.

Example 2
Command 'F ACF2,REFRESH(OPTS),SYSID(MES3)' is issued.
Since SYSID(MES3) was specified on the command, the 'active' SYSID MESB is ignored and SYSID MES3 will be used to search for GSO OPTS records. The 'GSO  MES* / OPTS' will be used because it is the most specific SYSID that matches.

Example 3
Command 'F ACF2,REFRESH(OPTS),SYSID(PROD)' is issued.
Since SYSID(PROD) was specified on the command, the 'active' SYSID MESB is ignored and SYSID PROD will be used to search for GSO OPTS records. The 'GSO  PROD / OPTS' will be used because it is the most specific SYSID that matches.

Example 4
Command 'F ACF2,REFRESH(OPTS),SYSID(TEST)' is issued.
Since SYSID(TEST) was specified on the command, the 'active' SYSID MESB is ignored and SYSID TEST will be used to search for GSO OPTS records. The 'GSO  **** / OPTS' will be used because it is the most specific SYSID that matches.

Example 5
Command 'F ACF2,REFRESH(OPTS),SYSID(-)' is issued.
Since SYSID(-) was specified on the command, the 'active' SYSID MESB is ignored and SYSID - will be used to search for GSO OPTS records. Note that the '-' is treated as a literal dash and not a masking character. The 'GSO  **** / OPTS' will be used because it is the most specific SYSID that matches.

Example 6
Command 'F ACF2,REFRESH(OPTS),SYSID(*)' is issued.
Since SYSID(*) was specified on the command, the 'active' SYSID MESB is ignored and SYSID * will be used to search for GSO OPTS records. Note that the '*' is treated as a literal asterisk and not a masking character. The 'GSO  **** / OPTS' will be used because it is the most specific SYSID that matches.