IAM/PLEX operator commands

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

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

Related topic

Using-IAM-PLEX-Record-Level-Sharing

The general format of the command is as follows:

F addressSpaceName,command

Example

The following command dumps an IAM/PLEX address space with the name IAMPLEX1:

F IAMPLEX1,DUMP

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

The IAM/PLEX commands are as follows:

Command	Description
ALTER,TOSYSID,LPARname	Specifies a target LPAR to override the z/OS Automatic Restart Manager (ARM) policy for automatic restarting of the IAM/PLEX address space if an LPAR fails TOSYSID—Specifies a target LPAR name if an LPAR fails. This options overrides the ARM policy for automatic restarting of the IAM/PLEX address space. LPARname—Specifies the new target LPAR to use when restarting the IAM/PLEX address space automatically This command provides the ability to alter the value specified in the TOSYSID parameter.
BACKOUT,loadModule	Backs out a dynamically loaded version if an abend occurs F IAMPLEX1,BACKOUT,IAMACCKS
CHANGEDSNT	Updates the list of data set names to be included or excluded from IAM/PLEX processing in the IAMDSNTB DD statement, enabling you tp pick up an updated list without having to stop and restart IAM/PLEX.
CHANGEPARM	Updates the current IAM/PLEX 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/PLEX. 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/PLEX.
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/PLEX. 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/PLEX
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/PLEX to display any record locks held that have contention (other requesters waiting for the lock) EXCLUDETB—Displays the data set name exclusion table IAMPLEX—Displays all the members in the IAM/PLEX RLSGROUP 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 IAMPLEX1,DISPLAY,RETAINEDLOCKS F IAMPLEX1,DISPLAY,CONT F IAMPLEX1,DISPLAY,SELECTTB F IAMPLEX1,DISPLAY,IAMPLEX F IAMPLEX1,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/PLEX 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 IAMPLEX1,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 displays 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/PLEX to close and locate the currently active file being used for output directed for the IAM/PLEX log (RLSLOGDD). Another SYSOUT data set is dynamically allocated by using the SYSOUT class specified in the IAM/PLEX startup parameters. If an actual RLSLOGDD DD card is in the IAM/PLEX 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 IAMPLEX1,OFFLOAD
MESSAGES=	Specifies which messages to print to the IAM/PLEX 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, RESTART, LPARname ]	Shuts down the IAM/PLEX address space. QUIESCE the current IAM file activity (batch and online) and restart the address space on the current or specified LPAR. Valid operands are as follows: FORCE—Closes all the IAM files and the IAM/PLEX address space terminates normally. All subsequent requests by the jobs that were processing data sets through the IAM/PLEX address space are rejected. If you do not specify FORCE, then the IAM/PLEX address space terminates and any new open requests are rejected when all of the open IAM files are closed. RESTART—Stops IAM file users' activity at their next checkpoint. For online transactions, this happens at the completion of the transaction. Further transactional activity to the IAM file is suspended. Batch jobs that do not take checkpoints are allowed to complete before the IAM/PLEX address space terminates. When you use BMC Application Restart Control (ARC) for VSAM, you can issue the PAUSE command ARC-enabled batch jobs to force ARC to take an immediate checkpoint, close files, and release resources. LPARname—(Optional) If you omit this operand, the current address space terminates and restarts on the current LPAR. If you include the operand, the current address space terminates and the IAM/PLEX address space restarts on the specified LPAR. LPARname must be an active LPAR in the sysplex. The TOSYSID parameter has no effect on the QUIESCE, RESTART command.
RELEASELOCKS RELLOCKS	Specifies that IAM/PLEX 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/PLEX 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 IAMPLEX1,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/PLEX procedure.
RESTART	Reverses a previously issued QUIESCE command that was issued without the FORCE keyword The IAM/PLEX address space resumes normal processing, and new open requests are honored. This command functions only if the IAM/PLEX address space has not already terminated. With the QUIESCE, RESTART command new IAMPLEX address space comes up when all the IAM data sets are closed. If you use ARC for restart logic in an application and the QUIESCE, RESTART command is issued, then the PAUSE command is automatically issued for to all ARC-enabled jobs. When the new IAMPLEX comes up, the PROCEED command is issued for all ARC-enabled jobs. For non-ARC jobs, if the QUIESCE,RESTART command is issued while they are running, the old IAM/PLEX terminates and the new IAM/PLEX comes up only after all jobs are completed. The old IAMPLEX is terminated immediately after issuing the QUIESCE, FORCE command, closing all the IAM data sets for both batch and online. For CICS, you can manually close all IAM data sets.
TRACE	Activates IAM/PLEX internal tracing. For more information about IAM/PLEX tracing by using the trace facility, IAM-PLEX-Tracing.

IAM/PLEX operator commands

BMC AMI Storage IAM 11.1

On this page