IAM/RLS Operator Commands

APPLY,dsn

This command is used to initiate application of BMC supplied PTFs to the modules loaded in the IAM/RLS address space storage. This facility enables customers to apply most maintenance without stopping and restarting IAM/RLS processing. For dsn, specify the name of a sequential or partitioned data set containing the fix to be applied. (For PDS’s, include the member name in parenthesis.) For example:

F IAMRLS,APPLY,IAMSYS.RLS.ICL(P910001)

CHANGEDSNT

This command will update the list of data set names to be included and/or excluded from IAM/RLS processing from the IAMDSNTB DD statement. This provides customers with a mechanism for picking up an updated list without having to stop and restart IAM/RLS.

CHANGEPARM

This command will update the current IAM/RLS parameters from the IPARMLIB DD statement file. While most parameters can be dynamically changed, some parameters will only effectively be changed by a restart of IAM/RLS. For example, because MAXLOCKS is used to set an internal table size established at startup, changing that value will not have any effect until IAM/RLS is restarted.

CLOSEFILE

This command will close the specified data set. It is intended to be used only in emergency circumstances to recover from a problem. Data sets are normally closed by the applications using IAM/RLS. The file should first be closed by the application or CICS region before attempting to issue the Closefile command. Additional operands, separated by commas, are:

DSN= Specifies the data set name.

One of the following is also required:

JOBNAME= Specifies the jobname for which the data set is to be closed.

JOBID= Specifies the JES JOBID that identifies the job for which the data set is to be closed.

ALL Specifies that the file is to be closed for every job that has it opened under IAM/RLS.

DISPLAY

This command, along with associated sub-parameters, will display requested information on the output file RLSLOGDD. The RLSLOGDD is used as a default because the output from the DISPLAY could be quite substantial. By adding the keyword ‘.CON’ to the end of the DISPLAY request, the information will be displayed on the operator’s console. One of the following parameters must be provided to indicate what information is to be displayed.

CONTENTION – Requests IAM/RLS to display any record locks held, that have contention (other requesters waiting for the lock).

EXCLUDETB – Indicates that the data set name exclusion table is to be displayed.

RETAINEDLOCKS[,DSN] – Indicates that information on the jobs, and optionally which data sets used by those jobs, have had locks retained due to an abend will be displayed.

SELECTTB – Indicates that the data set name selection table is to be displayed.

For example: F IAMRLS,DISPLAY,RETAINEDLOCKS

DJBTRACE=

This command is used to activate or deactivate the Dynamic Job Backout tracing. The Dynamic Job Backout trace is useful for determining exactly what file activity is being performed by Dynamic Job Backout. This can be used to verify proper operation, or for problem diagnosis relating to the recovery processing. When the trace is activated, by specifying DJBTRACE=YES, the next time a backout is attempted, the backout will dynamically allocate the RLSDJBDD file to a SYSOUT data type of data set. When deactivated, by DJBTRACE=NO, upon completion of a backout, the output for the trace will be closed and deallocated. Valid values are:

YES – Activate IAM/RLS Dynamic Job Backout tracing.

NO – Deactivate IAM/RLS Dynamic Job Backout tracing.

DUMP

JSWITCH

This command causes logging to switch from the currently active log data set to the next log data set.

LOGSWITCH

This command causes IAM/RLS to close and deallocate the currently active file being used for output directed for the IAM/RLS log (RLSLOGDD). Another SYSOUT data set will be dynamically allocated using the SYSOUT class specified in the IAM/RLS startup parameters. If an actual RLSLOGDD DD card is in the IAM/RLS startup proc, then this command is ignored.

LOGGER

These are some commands to help deal with any problems with the System Logger. What can be done is that, if there is a catastrophic error with the logstream, or coupling facility, they can disconnect from the current logstream, define a new logstream, change the RLS parmlib, run the changeparms command, then reconnect to the new logstream. At that point BJRNL should get posted by the SRB to recover, but just in case they can issue the POST command to get things started.

There are 4 different parameters:

DISCON - Used to disconnect from the current System Logger logstream

RECON - Used to reconnect to the System Logger logstream

OFFLOAD - Used to start an offload for the current logstream

POST - Post the journal subtask to start writing log records again

For Example: F iamplex1,OFFLOAD

MESSAGES=

Specifies what messages should be printed to the IAM/RLS RLSLOGDD file. Valid values are ALL, INFO, or ERR. ALL is primarily intended for problem diagnosis, as various messages will be written indicating many frequent events. INFO will provide a fairly detailed activity log, including when data sets are opened and closed. ERR will limit the RLSLOGDD messages to only those issued in error situations.

QUIESCE[,FORCE]

RELEASELOCKS

RELLOCKS

Specifies that IAM/RLS is to release locks for the specified job or CICS transaction. Either retained or held locks may be released. Additional parameters may also be required to further identify the specific job step if there are multiple matches on the job name. The information necessary to provide the details required by this command can be obtained from the DISPLAY,RETAINEDLOCKS command. The following sub-parameters can be specified:

JOBNAME= specifies the 1 to 8 character job name.

JOBID= Specifies the 8 character JES jobid, for example: JOB12345

ASID= Specifies the hexadecimal digits of the address space ID number.

STEPNAME= Specifies the 1 to 8 character step name, and is optional.

TRNAME= Specifies the 1 to 4 character CICS transaction name.

TRID= Specifies the CICS transaction number, in 1 to 5 decimal digits.

RESTART

This command will reverse a previously issued QUIESCE command that was issued without the FORCE keyword. Normal processing will be resumed by the IAM/RLS address space, and new open requests will be honored. This will only function if the IAM/RLS address space has not already terminated.

RESTORE,dsn

TRACE

This command activates the IAM/RLS internal tracing. Refer to the IAM-RLS-Tracing on IAM/RLS tracing for additional information on using the trace facility.