Sample JCL and parameter library (TOSZCNTL)


This library contains several samples that you can use to configure the RTCS started task PROCs and the RTCS initialization member. The library also contains sample JCL to execute the RTCS RMU and sample parameter input members for RTCS registry definitions.

The following TOSZCNTL library members are of particular interest after RTCS is installed and when a target z/OS image is being configured to run RTCS:

Member

Description

OSZ$INIT

OSZ$INIT is sample RTCS Initiator started task procedure (PROC) JCL. Copy this member into SYS1.PROCLIB (or another Master Subsystem started task procedure library that is specified in the z/OS image’s Master JCL). BMC recommends naming this copy OSZINIT; however, this is not required.

Customize the STEPLIB DD statement to specify the DSNAME of the RTCS subsystem program library.

  • If OSZINIT is to be started under the z/OS Master Subsystem (MSTR), the PROC must be located in SYS1.PROCLIB (or equivalent). You would then use the following operator command to start the RTCS Initiator:

    S OSZINIT,SUB=MSTR
  • But if OSZINIT is to be started under the Primary JES, the PROC can be located in any JES-managed started task PROCLIB. You would then use the following operator command to start the RTCS Initiator:

    S OSZINIT

OSZ$RTCS

OSZ$RTCS is sample RTCS subsystem started task procedure (PROC) JCL. If OSZINIT is started under the Master Subsystem, the PROC must be located in SYS1.PROCLIB (or equivalent) because OSZRTCS will also, by default, be started by the RTCS Initiator (internally) under the z/OS Master Subsystem (MSTR).

Because no parameters, data sets, or DD statements exist in this PROC, customization is unnecessary. Copy this member into SYS1.PROCLIB (or another Master Subsystem started task procedure library that is specified in the z/OS image’s Master JCL) if RTCS is to be started under the Master Subsystem, or into a JES-managed PROCLIB if RTCS is to be started under the primary JES. BMC recommends naming the copy OSZRTCS. You must specify the RTCS subsystem PROC name in the OSZRTCS-PROC option in the RTCS initialization member of Logical PARMLIB.

OSZ$EXEC

OSZ$EXEC is sample RTCS Generalized Server address space started task procedure (PROC) JCL. Because no parameters, data sets, or DD statements exist in this PROC, customization is unnecessary.

Copy this member to both of the following locations:

  • Any JES started task procedure library
  • SYS1.PROCLIB (or another Master Subsystem started task procedure library that is specified in the z/OS image's master JCL)

BMC recommends naming the copy OSZEXEC. You must specify the RTCS Generalized Server PROC name in the OSZEXEC-PROC option in the RTCS initialization member of Logical PARMLIB.

OSZ$REGI

OSZ$REGI is sample JCL that is used to execute the RTCS Registry Maintenance Utility (RMU).

Copy this member to a site-specific data set. In addition to the JOB statement, the JCL has DD statements that need to be customized to specify the DSNAMEs of the SMP/E TOSZRXML target XML document library as well as any customized XML document library.

OSZRBACK

OSZRBACK is sample JCL that is used to perform RMU backup processing. Copy this member to a site-specific data set. The BACKUP control statement in OSZRBACK writes a portable, sequential backup of the data in an RTCS registry to the data set defined by the specified ddname. You must specify the ddname of the backup data set.

OSZRREST

OSZRREST is sample JCL that is used to perform RMU restore processing.

Copy this member to a site-specific data set. The RESTORE control statement in OSZRREST restores the contents of the sequential backup data set defined by the specified ddname to the currently active registry. You must specify the ddname of the backup data set that you want to restore.

OSZSCHED

OSZSCHED is a sample set of required SYS1.PARMLIB PPT additions for RTCS.

You can copy this member as is into the appropriate z/OS target image-specific PARMLIB data set. Copy it as a new member named SCHEDxx, or copy its contents into any existing PPT member.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*