This section provides information about the operator commands that support RTCS Subsystem address space and Generalized Server address spaces. You enter an operator command using the z/OS MODIFY command or the letter F, which is an abbreviated version of the z/OS MODIFY command.
The command syntax is as follows:
F cscbName,command [subcommand [operand1 [... operandn] ] ]
The following table describes the operator parameters:
| |
|---|
| The name of the Command Scheduling Control Block (CSCB) that z/OS builds for the address space to which the command is being directed Valid CSCB names are: - For the RTCS Subsystem address space, the CSCB name is the RTCS z/OS Subsystem Identifier (SSID).
- For any Generalized Server address space, the CSCB name is the three-character product identifier.
- For a batch job, the CSCB name is the job name.
- For any other started task, a valid CSCB name is either the PROC name or the name specified after the period following the started task PROC name.
|
| One of the following operator commands: |
| The name of the subcommand. This indicates the action that you want to perform. |
| Some of the subcommands have additional parameters (known as operands). You can add multiple operands separated by a comma or a space. |
Operator commands
The following operator commands are available for RTCS:
REGISTRY
This command performs various functions for managing your RTCS Subsystem SYSTEM registry.
The REGISTRY command syntax is as follows:
F cscbName,REGISTRY,request [operand]
The REGISTRY request commands are as follows:
- ACQUIRE
- ALTER
- EXPOSE
- HARDEN
- REALLOCATE
- REINIT
- RELEASE
- STATUS
- TRANSFER
- UNEXPOSE
- UNALLOCATE
For more information, see REGISTRY-request-commands.
REFRESH
The REFRESH command syntax is as follows:
F RTCS,REFRESH,[KERNEL | LIBRARY | SECURITY]
| |
|---|
| This parameter is used to refresh the current kernel. If the program object in the TOSZRTCS library is different from the currently loaded program object in the current DLL packages, this command refreshes OSZKERNL. The command syntax is as follows: F RTCS,REFRESH,KERNEL [FORCE | UPGRADE | BACKLVL | MIXTURE] Example F RTCS,REFRESH,KERNEL F RTCS,REFRESH,KERNEL
OSZ0190I POSZLINK = OSZ30.BOLWHB.LINKLIB
OSZ0190I POSZRTCS = OSZ30.BOLWHB.LINKLIB
OSZ0069I //SYS00002 DD DISP=SHR,DSN=OSZ30.BOLWHB.LINKLIB
OSZ0130I PACKAGE OSZKERNL REFRESH CANDIDATE MAINTENANCE LEVEL ANALYSIS
035
PROGRAM OBJECT=OSZKERNL PACKAGE DIRECTORY=14163B00
SERVICE LEVEL=ZOSZ300
PACKAGE KCSN=00031 ENTRY/ALIAS DIRECTORY=14163A00
KERNELCOMPAT=00031
LOCATION DESC=HIGH PRIVATE (SWA/AUK/LSQA) BELOW 16MB
PRODUCT NAME=RTCS
VENDOR NAME=BMC SOFTWARE
REGISTRY KEYS: VENDOR=BMC PRODUCT=RTCS SECURITY APPL=RTCS
PACKAGE PACKAGE PRODUCT PACKAGE MIN.RTCS PRODUCT ELEMENT
LOCATION DATE TIME FMID RMID V R M C V R M C COUNT
-------- -------- -------- ------- ------- -------- -------- ------
CURRENT 20210405 20.35 ZOSZ300 BP00454 03000000 0300001D 00073
LIBRARY 20210405 20.35 ZOSZ300 BP00454 03000000 0300001D 00073
----------CURRENT--------- ----------LIBRARY-----------------
ELEMENT DATE TIME RMID ZAP DATE TIME RMID ZAP STATUS
-------- -------- ----- ------- --- -------- ----- ------- --- -------
OSZKERNL 20210405 20.35 BP00454 20210405 20.35 BP00454 SAME
OSZASPAC 20210405 20.38 ZOSZ300 20210405 20.38 ZOSZ300 SAME
OSZASYNC 20210405 20.38 BP00463 20210405 20.38 BP00463 SAME
OSZAUPTR 20210405 20.38 ZOSZ300 20210405 20.38 ZOSZ300 SAME
OSZCLARY 20210405 20.38 ZOSZ300 20210405 20.38 ZOSZ300 SAME
OSZCMPRS 20210405 20.38 BP00467 20210405 20.38 BP00467 SAME
OSZCMPR2 20210405 20.39 ZOSZ300 20210405 20.39 ZOSZ300 SAME
OSZCMPR3 20210405 20.39 ZOSZ300 20210405 20.39 ZOSZ300 SAME
OSZCOMND 20210405 20.39 ZOSZ300 20210405 20.39 ZOSZ300 SAME
MODULES ARE EQUIVALENT, REFRESH WILL NORMALLY BE BYPASSED
THE EXISTING MODULE DOES NOT NEED TO BE REFRESHED
TO FORCE THE MODULE TO BE REFRESHED, PUT
",FORCE" AT THE END OF THE REFRESH COMMAND
OSZ0108E REFRESH COMMAND FAILED: 036
MODULE IN RTCS LIBRARY IS AT SAME MAINTENANCE LEVEL
OSZ0031I COMMAND WAS PROCESSED |
| This parameter refreshes the OSZLIBC, OSZLIBM, and OSZGCC2 objects if any program object in the TOSZRTCS library is different from the currently loaded program object in the current DLL packages. Example F RTCS,REFRESH,LIBRARY F RTCS,REFRESH,LIBRARY
OSZ0069I //SYS00004 DD DISP=SHR,DSN=OSZ30.BOLWHB.LINKLIB
OSZ0130I PACKAGE OSZLIBC REFRESH CANDIDATE MAINTENANCE LEVEL ANALYSIS
085
PROGRAM OBJECT=OSZLIBC PACKAGE DIRECTORY=1402F400
SERVICE LEVEL=ZOSZ300
PACKAGE KCSN=00010 ENTRY/ALIAS DIRECTORY=1402F200
OSZA MINKCSN=00010 MAIN FUNCTION RTCS@EP=00000000
KERNELCOMPAT=00031
LOCATION DESC=HIGH PRIVATE (SWA/AUK/LSQA) BELOW 16MB
PRODUCT NAME=RTCS
VENDOR NAME=BMC SOFTWARE
REGISTRY KEYS: VENDOR=BMC PRODUCT=RTCS SECURITY APPL=RTCS
PACKAGE PACKAGE PRODUCT PACKAGE MIN.RTCS PRODUCT ELEMENT
LOCATION DATE TIME FMID RMID V R M C V R M C COUNT
-------- -------- -------- ------- ------- -------- -------- ------
CURRENT 20210329 11.59 ZOSZ300 ZOSZ300 03000000 03000009 00173
LIBRARY 20210405 20.33 ZOSZ300 ZOSZ300 03000000 03000009 00173
----------CURRENT--------- ----------LIBRARY-----------------
ELEMENT DATE TIME RMID ZAP DATE TIME RMID ZAP STATUS
-------- -------- ----- ------- --- -------- ----- ------- --- -------
OSZLIBC 20210329 11.59 ZOSZ300 20210405 20.33 ZOSZ300 UPDATED
OSZLCD98 20210329 12.23 BASE 20210405 20.54 BASE UPDATED
OSZLCD99 20210329 12.07 BASE 20210405 20.39 BASE UPDATED
OSZLCE00 20210329 12.02 BASE 20210405 20.36 BASE UPDATED
OSZLCL00 20210329 12.22 BASE 20210405 20.53 BASE UPDATED
SOME LIBRARY ELEMENTS HAVE BEEN UPDATED, AND NONE
HAVE BEEN BACKLEVELED, SO THE REFRESH IS ALLOWED
OSZ0130I PACKAGE OSZLIBM REFRESH CANDIDATE MAINTENANCE LEVEL ANALYSIS
086
PROGRAM OBJECT=OSZLIBM PACKAGE DIRECTORY=1401C400
SERVICE LEVEL=ZOSZ300
PACKAGE KCSN=00008 ENTRY/ALIAS DIRECTORY=1401C200
OSZA MINKCSN=00008 MAIN FUNCTION RTCS@EP=00000000
KERNELCOMPAT=00031
LOCATION DESC=HIGH PRIVATE (SWA/AUK/LSQA) BELOW 16MB
PRODUCT NAME=RTCS
VENDOR NAME=BMC SOFTWARE
REGISTRY KEYS: VENDOR=BMC PRODUCT=RTCS SECURITY APPL=RTCS
PACKAGE PACKAGE PRODUCT PACKAGE MIN.RTCS PRODUCT ELEMENT
LOCATION DATE TIME FMID RMID V R M C V R M C COUNT
-------- -------- -------- ------- ------- -------- -------- ------
CURRENT 20210329 11.59 ZOSZ300 ZOSZ300 03000000 03000007 00021
LIBRARY 20210405 20.33 ZOSZ300 ZOSZ300 03000000 03000007 00021
----------CURRENT--------- ----------LIBRARY-----------------
ELEMENT DATE TIME RMID ZAP DATE TIME RMID ZAP STATUS
-------- -------- ----- ------- --- -------- ----- ------- --- -------
OSZLIBM 20210329 11.59 ZOSZ300 20210405 20.33 ZOSZ300 UPDATED
OSZLCM31 20210329 12.00 BASE 20210405 20.33 BASE UPDATED
OSZLCM36 20210329 12.00 BASE 20210405 20.34 BASE UPDATED
OSZLCM61 20210329 12.00 BASE 20210405 20.34 BASE UPDATED
OSZLCM63 20210329 12.01 BASE 20210405 20.34 BASE UPDATED
SOME LIBRARY ELEMENTS HAVE BEEN UPDATED, AND NONE
HAVE BEEN BACKLEVELED, SO THE REFRESH IS ALLOWED
OSZ0107I REFRESH COMMAND PROCESSED SUCCESSFULLY 087
FOR MODULES(OSZLIBC OSZLIBM )
OSZ0031I COMMAND WAS PROCESSED |
| This parameter refreshes the RTCS security parameters by directing the RTCS Security Manager (RMU) to reinitialize every global security parameter values that are stored in the RTCS Subsystem SYSTEM registry. Use this parameter only when RMU has changed the RTCS security parameters. Users of the BMC AMI Ops Infrastructure product do not require this parameter as BMC AMI Ops Infrastructure controls its own security parameters. Example F RTCS,REFRESH,SECURITY F RTCS,REFRESH,SECURITY
OSZ0418I ACF2 FDR(CA ACF2 REL 16.0 14.25 08/17/20)
OSZ0437I (SYSTEM) ALET=00070003 ASSIGNED BY ALESERV TO TCB=007D97F8
OSZ0432I SECURITY ESMTYPE(ACF2) SELECTED BY ESMTYPE(AUTO)
OSZ0443I RTCS SECURITY - SAFSUBSYS(&SSID ) APPLID(&PRODUCT)
OSZ0444I UNDEFINEDUSERINHERIT(ACCEPT) UNDEFINEDUSERSIGNON(REJECT)
OSZ0445I GROUPINHERIT(ALWAYS) DEFAULTUSERID(<BLANKS>)
OSZ0446I SECTRACE(NONE ) TESTMODE(**)
OSZ0447I ESM(ACF2) RCVT ID(ACF2) VRMN(7791) FLGS(03000840000000F5F000)
OSZ0031I COMMAND WAS PROCESSED |
PACKAGE
The various flavors of the command syntax are as follows:
F RTCS,PACKAGE,[MAINT | STATUS]
F cscbName,PACKAGE,{STATUS | MAINT} {group | package}
| |
|---|
| Examines the package or a group of packages and display the applied maintenance. Elements in the package with no PTFs for ZAPs applied to them are not listed in the resulting output. |
| Displays the status of all elements in the package or group of packages. The resulting response might contain a very large number of lines because all SMP/E elements in the package or group of packages are displayed. The following example displays only the elements in the package OSZLIBR0 to which any PTFs applied since the last maintenance: Examples F RTCS,PACKAGE,MAINT,OSZLIBR0 F RTCS,PACKAGE,MAINT,OSZLIBR0
OSZ0190I POSZRTCS = OSZ30.BOLWHB.LINKLIB
OSZ0190I POSZLINK = OSZ30.BOLWHB.LINKLIB
OSZ0132I PACKAGE OSZLIBR0 EXCEPTIONAL MAINTENANCE LEVEL ANALYSIS 104
PROGRAM OBJECT=OSZLIBR0 PACKAGE DIRECTORY=142E8C00
SERVICE LEVEL=ZOSZ300
PACKAGE KCSN=00018 ENTRY/ALIAS DIRECTORY=142E8200
OSZA MINKCSN=00018 MAIN FUNCTION RTCS@EP=00000000
KERNELCOMPAT=00031
LOCATION DESC=HIGH PRIVATE (SWA/AUK/LSQA) BELOW 16MB
PRODUCT NAME=RTCS
VENDOR NAME=BMC SOFTWARE
REGISTRY KEYS: VENDOR=BMC PRODUCT=RTCS SECURITY APPL=RTCS
PACKAGE PACKAGE PRODUCT PACKAGE MIN.RTCS PRODUCT ELEMENT
LOCATION DATE TIME FMID RMID V R M C V R M C COUNT
-------- -------- -------- ------- ------- -------- -------- ------
PVTHI 20210329 11.59 ZOSZ300 ZOSZ300 03000000 0300000E 00007
ELEMENT DATE TIME RMID ZAP STATUS
-------- -------- ----- ------- --- -------
OSZDYALC 20210329 11.59 BP00446 PTF
OSZ0031I COMMAND WAS PROCESSED F RTCS,PACKAGE,STATUS,OSZLIBR0 F RTCS,PACKAGE,STATUS,OSZLIBR0
OSZ0190I POSZRTCS = OSZ30.BOLWHB.LINKLIB
OSZ0190I POSZLINK = OSZ30.BOLWHB.LINKLIB
OSZ0133I PACKAGE OSZLIBR0 CURRENT MAINTENANCE LEVEL REPORT 109
PROGRAM OBJECT=OSZLIBR0 PACKAGE DIRECTORY=142E8C00
SERVICE LEVEL=ZOSZ300
PACKAGE KCSN=00018 ENTRY/ALIAS DIRECTORY=142E8200
OSZA MINKCSN=00018 MAIN FUNCTION RTCS@EP=00000000
KERNELCOMPAT=00031
LOCATION DESC=HIGH PRIVATE (SWA/AUK/LSQA) BELOW 16MB
PRODUCT NAME=RTCS
VENDOR NAME=BMC SOFTWARE
REGISTRY KEYS: VENDOR=BMC PRODUCT=RTCS SECURITY APPL=RTCS
PACKAGE PACKAGE PRODUCT PACKAGE MIN.RTCS PRODUCT ELEMENT
LOCATION DATE TIME FMID RMID V R M C V R M C COUNT
-------- -------- -------- ------- ------- -------- -------- ------
PVTHI 20210329 11.59 ZOSZ300 ZOSZ300 03000000 0300000E 00007
ELEMENT DATE TIME RMID ZAP STATUS
-------- -------- ----- ------- --- -------
OSZLIBR0 20210329 11.59 ZOSZ300
OSZDYALC 20210329 11.59 BP00446 PTF
OSZDYALN 20210329 11.59 ZOSZ300
OSZIRSEC 20210329 12.00 ZOSZ300
OSZRGSRI 20210329 12.00 ZOSZ300
OSZ0RTNA 20210329 12.00 ZOSZ300
OSZIRXCN 20210329 12.00 ZOSZ300
OSZ0031I COMMAND WAS PROCESSED |
SECTRACE
The command syntax is as follows:
F cscbName,SECTRACE,[NONE | ON | SIMPLE | EXTENDED | COMPLETE]
This command indicates the level of diagnostic trace messages for the RTCS Security Manager component to issue.
Examples
F RTCS,SECTRACE COMPLETE
OSZ0063I SECTRACE(COMPLETE) IS NOW IN EFFECT
F RTCS,SECTRACE NONE
OSZ0063I SECTRACE(NONE) IS NOW IN EFFECT
WARNMSG
The command syntax is as follows:
F cscbName,WARNMSG {ON | OFF}
This command indicates whether the RTCS functions that are running in the address space should issue the normally-suppressed warning messages.
Example
F RTCS,WARNMSG,ON
OSZ0109I WARNMSG IS ON IN OSZRTCS (ASID=X'0023',CSCB=RTCS)
OSZ0031I COMMAND WAS PROCESSED