| |
|---|
| 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:
The RTCS Subsystem displays all address spaces that have established a connection to the RTCS Subsystem.
The DA command syntax is as follows:
F RTCS,DA | DISPLAY ACTIVE
F RTCS,DA
OSZ0260I Address spaces using RTCS 532
JOB Name JESJOBID ASID Type STEP PROC PROCSTEP CSCB
-------- -------- ---- ---- -------- -------- -------- --------
BMCTOM STC15313 003D STC *START BMCTOM MVTOM BMCTOM
OSZRTCS STC15297 0048 RTCS *START OSZRTCS OSZRTCS RTCS
SVOSP STC15320 0057 STC *START SVOSP SVOS SVOSP
BMCMVTCP STC15479 006C STC *START BMCMVTCP TACMDSP4 MTP
BMCCAS STC15355 0072 STC *START BMCCAS CAS CAS
BMCPAS STC15356 0075 STC *START BMCPAS PAS PAS
BMCDBC STC15456 00BC STC *START BMCDBC DBC MVSB
-------- -------- ---- ---- -------- -------- -------- --------
OSZ0261I All address spaces using RTCS have been listed
OSZ0263I DISPLAY,ACTIVE completed
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-parameters.
The REFRESH command syntax is as follows:
F RTCS,REFRESH,[KERNEL | LIBRARY | SECURITY | TYPECODE]
| |
|---|
| This parameter is used to refresh the RTCS Kernel. If the OSZKERNL program object in the POSZRTCS program library is different from the currently active, in-use RTCS Subsystem Kernel, this command dynamically refreshes the Kernel by loading the (changed) OSZKERNL program object from the POSZRTCS program library into DLPA. The command syntax is as follows: F RTCS,REFRESH,KERNEL [FORCE | UPGRADE | BACKLVL | MIXTURE] | |
|---|
| Refreshes the RTCS Kernel regardless of the maintenance level of the elements in the OSZKERNL program object in the POSZRTCS RTCS Subsystem Program Library. | | Refreshes the RTCS Kernel only if the OSZKERNL program object in the POSZRTCS RTCS Subsystem Program Library has been upgraded with one or more newer, updated elements. | | Use this option when a previous RTCS Kernel update includes one or more elements that contain an error and have already been backed off (via an SMP/E RESTORE). For example, a PTF to the OSZKERNL program object that was previously deployed via a REFRESH KERNEL command. Specifying BACKLVL indicates to the REFRESH command that the previous maintenance level of the OSZKERNL program object has already been replaced or restored in the POSZRTCS RTCS Subsystem Program Library. The REFRESH command processing allows a previous maintenance level of the RTCS Kernel program object to replace the current in-storage Kernel, which contains the code in error that must be backed off. | | Refreshes the RTCS Kernel even if the OSZKERNL program object in the POSZRTCS RTCS Subsystem Program Library contains both newer (updated elements) and older (backlevel elements). For example, when PTFs have been applied to OSZKERNL that updated one or more elements to a newer level and backlevel one or more elements to a level prior to what is currently in the active RTCS Kernel. |
Example F RTCS,REFRESH,KERNEL F RTCS,REFRESH,KERNEL
OSZ0190I POSZLINK = prefix.BMC.POSZLINK
OSZ0190I POSZRTCS = prefix.BMC.POSZRTCS
OSZ0069I //SYS00002 DD DISP=SHR,DSN=prefix.BMC.POSZRTCS
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 and OSZLIBM DLL packages if their POSZRTCS library program objects are different from those currently loaded in DLPA. Example F RTCS,REFRESH,LIBRARY F RTCS,REFRESH,LIBRARY
OSZ0069I //SYS00004 DD DISP=SHR,DSN=prefix.BMC.POSZRTCS
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 directs the RTCS Security Manager to refresh the RTCS Global Security Parameters stored in the RTCS Subsystem SYSTEM Registry. Use this parameter only when you have updated the RTCS Global Security Parameters by using the RTCS Registry Maintenance Utility (RMU). 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 |
| This parameter results in the SYSTEM and MEMORY Registry-resident CORBA typecode structure definitions that exist in the current, in-storage RTCS Kernel that is updated in those registry instances. Usually, the REFRESH TYPECODE command is never required, because these structures are automatically refreshed during the RTCS Subsystem address space initialization (when the RTCS Kernel being loaded contains more up to date definitions than already existing definitions in those registry instances). However, when a newly defined backing VLDS for the SYSTEM Registry is brought online into use, for example, by a REGISTRY ACQUIRE command, these CORBA typecode structure definitions does not present; therefore, you must store these definitions in the new empty registry. To update the new SYSTEM Registry's backing VLDS, use the REFRESH TYPECODE command. If the existing CORBA typecode structure definitions present in the SYSTEM and MEMORY Registry instances are up to date, no substantive command response messages are issued to SYSLOG. |
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
OSZ0190I POSZLINK = prefix.BMC.POSZLINK
OSZ0190I POSZRTCS = prefix.BMC.POSZRTCS
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 POSZLINK = prefix.BMC.POSZLINK
OSZ0190I POSZRTCS = prefix.BMC.POSZRTCS
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 |
| Specifies a group of packages, such as, KERNEL, LIBRARY, and RESLIBS. |
| Specifies the name of a program object previously loaded into the address space |
This command specifies the names of various resources.
The command syntax is as follows:
F RTCS,SET resource=resourceName
The following list includes the command with the available resources:
- F RTCS,SET OSZEXEC=procname
Modifies the RTCS Generalized Server started task PROC name value, which was set by default when the RTCS Initiator address space (OSZINIT) was running or explicitly specified by the OSZEXEC-PROC= option in the RTCS Initialization member.
- F RTCS,SET POSZRTCS=dsname
Modifies the DSNAME of the RTCS Subsystem Program Library, which was specified in the STEPLIB DD statement for the RTCS Initiator address space (OSZINIT).
- F RTCS,SET POSZLINK=dsname
Modifies the DSNAME of the RTCS Product Program Library, which was set by default when the RTCS Initiator address space (OSZINIT) was running or explicitly specified by the POSZLINK= option in the RTCS Initialization member.
- (BMC.AMIOPS.SPE2401)F RTCS,SET SDOM=securitydomain
Modifies the security domain, which was set by default when the RTCS Initiator address space (OSZINIT) was running or explicitly indicated by the SDOMAIN= option in the RTCS Initialization member.
- (BMC.AMIOPS.SPE2401)F RTCS,SET DIDUN=rulesstring
Modifies the distributed identity user name rules string, which was set by default when the RTCS Initiator address space (OSZINIT) was running or explicitly indicated by the DIDUN= option in the RTCS Initialization member.
- (BMC.AMIOPS.SPE2401)F RTCS,SET DIDRN=rulesstring
Modifies the distributed identity user name rules string, which was set by default when the RTCS Initiator address space (OSZINIT) was running or explicitly indicated by the DIDRN= option in the RTCS Initialization member.
This command indicates the level of diagnostic trace messages for the RTCS Security Manager component to issue.
The command syntax is as follows:
F cscbName,SECTRACE,[NONE | ON | SIMPLE | EXTENDED | COMPLETE]
Examples
F RTCS,SECTRACE COMPLETE
OSZ0063I SECTRACE(COMPLETE) IS NOW IN EFFECT
F RTCS,SECTRACE NONE
OSZ0063I SECTRACE(NONE) IS NOW IN EFFECT
F RTCS,SHUTDOWN [LIST | nnn]
- LIST—Displays a list of address spaces that have established a connection to the RTCS Subsystem that needs to terminate before a shutdown of RTCS (via a P RTCS or F RTCS,SHUTDOWN command) is processed.
- nnn—RTCS attempts to shut down the RTCS Subsystem address space after nnn seconds have elapsed instead of immediately. If at the end of the specified interval, the address spaces that have established a connection to the RTCS Subsystem remain active, then RTCS does not shutdown. The delayed initiation of an RTCS shutdown enables an automation product to issue the SHUTDOWN,nnn command before the automation product terminates other address spaces under its control and then itself terminates. An automation product uses this form of the SHUTDOWN command because after the product terminates, it cannot issue either a P RTCS or an F RTCS,SHUTDOWN command (which must occur so that the RTCS address space can terminate itself). By using this deferred shutdown command, an automation product can itself issue START RTCS and request that RTCS shut itself down.
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