IAM/RLS operator commands

You can control the following IAM/RLS address space behaviors by using an IAM/RLS command on the IBM z/OS MODIFY (F) command:

Shutting down the IAM/RLS address space. For more information, see QUIESCE.
Causing the IAM/RLS address space to schedule a dump to a SYS1.DUMPxx data set. For more information, see DUMP.
Activating and stopping the IAM/RLS trace facility. For more information, see DJBTRACE=.
Applying PTFs to an active IAM/RLS address space. For more information, see REPLACEMOD.

Related topic

Using-IAM-Record-Level-Sharing

The general format of the command is as follows:

F IAMRLSaddressSpaceName,command

Example

For example, to dump an IAM/RLS address space with the name IAMRLS1:

F IAMRLS1,DUMP

Some of the commands prompt you to enter additional information via a WTOR.

The IAM/RLS commands are as follows:

Command	Description
BACKOUT,loadModule	Backs out a dynamically loaded version if an abend occurs. F IAMRLS1,BACKOUT,IAMACCKS
CHANGEDSNT	Updates the list of data set names to be included or excluded from IAM/RLS processing in the IAMDSNTB DD statement, enabling you to pick up an updated list without having to stop and restart IAM/RLS.
CHANGEPARM	Updates the current IAM/RLS parameters from the data set and member specified on the IPARMLIB DD statement Although you can dynamically change most parameters, you can effectively some parameters only by restarting IAM/RLS. For example, if MAXLOCKS is set to an internal table size established at startup, changing that value does not take any effect until you restart IAM/RLS.
CLOSEFILE	Closes the specified data set Error Warning Use this command only in emergencies to recover from a problem. Data sets are normally closed by the applications using IAM/RLS. Before using this command, you must close the file by using the application or CICS region. Additional operands, separated by commas, are as follows: DSN=—Specifies the data set name. JOBNAME=—Closes the data set with the specified job name JOBID=—Closes the data set with the specified JES JOBID ALL—Closes all the files for every job open in the IAM/RLS
DISPLAY	Displays the requested information on the RLSLOGDD output file with the associated sub-parameters The RLSLOGDD file is used as a default because, the output from the DISPLAY could be quite substantial. To display the information on the operator’s console, specify CON at the end of the command. Use one of the following sub-parameters to display the required information: CONTENTION—Requests IAM/RLS to display any record locks held that have contention (other requesters waiting for the lock) EXCLUDETB—Displays the data set name exclusion table RETAINEDLOCKS[,DSN]—Displays information about the jobs, and optionally the data sets used by those jobs, that have had locks retained due to an abend. SELECTTB—Displays the data set name selection table. STATS—Generates the RLSINFO report manually. The output goes to the RLSINFO DD rather than to the RLSLOGDD DD. For example: F IAMRLS1,DISPLAY,RETAINEDLOCKS F IAMRLS1,DISPLAY,CONT F IAMRLS1,DISPLAY,SELECTTB F IAMRLS1,DISPLAY,STATS
DJBTRACE=	Activates or deactivates Dynamic Job Backout tracing The Dynamic Job Backout tracing is useful for determining exactly what file activity Dynamic Job Backout is performing to verify proper operation or to diagnose problems relating to recovery processing. Valid operands are as follows: YES—Activate tracing so that the next time a backout is attempted, the backout dynamically allocates the RLSDJBDD file to a SYSOUT data type of data set. NO—Deactivate tracing so that, on completion of a backout, the output for the trace is closed and deallocated.
DUMP	Requests the IAM/RLS address space to send a dump to a SYS1.DUMPxx data set The dump automatically includes the data space containing the IAM index space.
JSWITCH	Switches logging from the currently active log data set to the next log data set
LISTPTFS	Lists all the modules that are eligible for REPLACEMOD and BACKOUT commands in the existing running address space and displays the status of these modules. F IAMRLS1,LISTPTFS Warning Important This command displays the list of module names along with most recent applied PTF and an extension indicator. When there are no PTFs applied to a module, the word BASE is displayed instead of a PTF name. Yes in the extension indicator column signifies that the module has a new version dynamically loaded and activated by the REPLACEMOD command and therefore is eligible for the BACKOUT command.
LOGSWITCH	Causes IAM/RLS to close and locate the currently active file being used for output directed for the IAM/RLS log (RLSLOGDD). Another SYSOUT data set is dynamically allocated by using the SYSOUT class specified in the IAM/RLS startup parameters. If an actual RLSLOGDD DD card is in the IAM/RLS startup procedure, then this command is ignored.
LOGGER	Addresses problems with the System Logger Valid operands are as follows: DISCON—Disconnect from the current System Logger logstream RECON—Reconnect to the System Logger logstream OFFLOAD—Start an offload for the current logstream POST—Post the journal subtask to start writing log records again If a catastrophic error with the logstream or coupling facility occurs, you can use these commands to disconnect from the current logstream, define a new logstream, change the RLS parmlib, run the CHANGEPARM command, and then reconnect to the new logstream. SRB should then be posted by the SRB to recover, but if it does not, you can issue the POST command. For example: F IAMRLS1,OFFLOAD
MESSAGES=	Specifies which messages to print to the IAM/RLS RLSLOGDD file Valid operands are as follows: ALL—Primarily intended to diagnose problems because various messages are written indicating many frequent events INFO—Provides a fairly detailed activity log, including when data sets are opened and closed ERR—Limits the RLSLOGDD messages to only those issued in error situations.
QUIESCE[,FORCE]	Shuts down the IAM/RLS address space. FORCE—Closes all the IAM files and the IAM/RLS address space terminates normally. All subsequent requests by the jobs that were processing data sets through the IAM/RLS address space are rejected. If you do not specify FORCE, then the IAM/RLS address space terminates and any new open requests are rejected when all of the open IAM files are closed.
RELEASELOCKS RELLOCKS	Specifies that IAM/RLS should release retained and held locks for the specified job or CICS transaction Use the DISPLAY,RETAINEDLOCKS command to obtain the requisite information for this command. If there are multiple job name matches, you might need to use the following operands to identify the specific job step: JOBNAME—Specifies the one- to eight-character job name JOBID—Specifies the eight-character JES JOBID (for example, JOB12345) ASID—Specifies the address space ID number in hexadecimal digits STEPNAME—(Optional) Specifies the one- to eight-character step name TRNAME—Specifies the one- to four-character CICS transaction name TRID—Specifies the CICS transaction number in 1 to 5 decimal digits
REPLACEMOD,loadModule	Dynamically loads a new version of modules that do not reflect the changes unless you recycle the address space. You can issue the IAM/RLS commands when specified as a parameter for the MODIFY command. Use the following command to load a new version of the IAMACCKS load module: F IAMRLS1,REPLACEMOD,IAMACCKS Warning Important A load library where the new versions of modules are uploaded should be referenced by the SYSLIB DD-name of the IAM/RLS procedure.
RESTART	Reverses a previously issued QUIESCE command that was issued without the FORCE keyword The IAM/RLS address space resumes normal processing, and new open requests are honored. This command functions only if the IAM/RLS address space has not already terminated.
TRACE	Activates IAM/RLS internal tracing. For more information about IAM/RLS tracing by using the trace facility, IAM-RLS-Tracing.

IAM/RLS operator commands

BMC AMI Storage IAM 11.1

On this page