IMS Version 9

Keyword Table and Definitions

|All IMS keywords and their synonyms |and environments, as well as keywords supported by the OM API, are |listed in Table 13. The section following the table describes |the keywords in greater detail.

|A keyword listed in the OM keyword column indicates |that it is the only accepted form supported by the OM API. If no |keyword is listed in the OM keyword column, then the IMS keyword |or its synonym is acceptable. If no synonyms are listed, none are permitted.

IMS ignores misspelled keywords; IMS issues an error message when it encounters an invalid keyword. In an IMSplex, invalid or misspelled keywords will result in an "UNKNOWN POSITIONAL PARAMETER" message.

|ALL=NO or ALL=DIS can be specified on the KEYWD macro to prevent use of the ALL parameter. ALL=NO and ALL=DIS can be specified for all keywords. ALL=NO indicates that the ALL parameter is invalid on all the commands for the keyword. ALL=DIS indicates the ALL parameter is invalid on all the /DISPLAY commands for the keyword. Note, the KEYWD macro only applies |to type-1 commands. For more information on the KEYWD macro, see IMS Version 9: Customization Guide.

Table 13. Keywords, Synonyms, and Their Environments
|IMS |Keyword |Synonym |OM Keyword |DB/DC |DBCTL |DCCTL
|ABDUMP | | |X |X |X
|ABORT | | |X |X |X
|ACCESS | | |X |X |
|ACTIVE |A, ACT |ACT |X |X |X
|ADD | | |X |X |
|ADS | | |X |X |
|AFFINITY |AFFIN, AFF |AFFIN |X | |X
|ALLENTRIES |ALLENT | |X |X |
|AOITOKEN |AOITKN |AOITKN |X |X |X
|APDB | | |X |X |
|APMQ | | |X | |X
|APPC | | |X | |X
|AREA | | |X |X |
|ASR | | |X | |X
|ASSIGNMENT |ASMT |ASMT |X | |X
|AUTO | | |X | |X
|AUTOARCH |ARCHIVE, AUTOARC |AUTOARCH |X |X |X
|AUTOLOGON |AUTLGN | |X | |X
|BACKUP |BU |BACKUP |X | |X
|BALGRP |BALG | |X | |X
|BKERR | | |X |X |
|BUILDQ |BLDQ, BLDQS, BUILDQS | |X | |X
|CAGROUP |CAGRP | |X |X |
|CANCEL | | |X |X |X
|CCTL |CC |CCTL |X |X |
|CHECKPOINT |CHECKPT, CHKPOINT, |CHKPT |CHKPT |X |X |X
|CLASS |CLS |CLASS |X | |X
|CMDAUTH | | |X | |X
|CMDAUTHE | | |X | |X
|CNS | | |X | |X
|COLDBASE |COLDB |COLDBASE |X |X |
|COLDCOMM |COLDC |COLDCOMM |X | |X
|COLDSESS | | |X | |X
|COLDSYS |COLDS |COLDSYS |X |X |X
|COMMIT | | |X |X |X
|COMP | | |X |X |
|COMPONENT |COMPT | |X | |X
|CONTINUOUS |CONT | |X | |X
|CONVERSATION |CONV |CONV |X | |X
|CPLOG | | |X | |X
|CPRI | | |X | |X
|CQS | | |X | |X
|CRD | | |X | |X
|DATABASE |DATABASES, |DB, DBS |DB |X |X |
|DATAGROUP |DATAGRP |DATAGRP |X |X |
|DBALLOC | | |X |X |
|DBD | | |X |X |
|DBDS | | |X |X |
|DBDSGRP | | |X |X |
|DBS | | |X |X |X
|DC | | |X | |X
|DESCRIPTOR |DESC, L62DESC |DESC |X | |X
|DIRECTORY |DIR |DIR |X | |X
|DONE | | |X | |X
|DUMPQ |DUMPQS |DUMPQ |X | |X
|EMHQ | | |X | |X
|ERRORABORT | | |X |X |
|ERRORCONT | | |X |X |
|EXIT | | |X | |X
|FDR | | |X |X |
|FORCE | | |X | |X
|FORCSESS |FORC | |X | |X
|FORMAT |FMT | |X |X |X
|FPPROG | | |X | |X
|FPREGION |FPRGN |FPRGN |X | |X
|FPVIRTUAL |FPV |FPV |X |X |
|FREEZE | | |X |X |X
|GLOBAL | | |X |X |
|GRSNAME |GRSN, GRS | |X | |X
|HSB |HOTSTANDBY |HSB |X | |X
|HSSP | | |X |X |
|ICOMPONENT |ICOMPT | |X | |X
|ID | | |X | |X
|IMS | | |X |X |X
|IMSPLEX | | |X |X |X
|INDOUBT |IND | |X |X |
|INPUT | | |X | |X
|INTERVAL |INT, INTV | |X |X |X
|ISOLOG | | |X |X |X
|JOBNAME |JBN, JOB | |X |X |X
|LE | | |X |X |X
|LA | | |X | |X
|LEAVEGR | | |X | |X
|LEAVEPLEX | | |X |X |X
|LEVEL | | |X | |X
|LINE |LINES |LINE |X | |X
|LINK | | |X | |X
|LMCT |LCT |LCT |X | |X
|LOCAL | | |X |X |
|LOGOND |LGND | |X | |X
|LOPEN | | |X | |X
|LPRI | | |X | |X
|LTERM |LTERMS |LTERM |X | |X
|LUNAME |LU, LUN |LU |X | |X
|MADSIOT | | |X |X |X
|MASTER | | |X | |
|MAXRGN | | |X | |X
| | |MEMBER | | |
|MODE |MODETABLE, MODETBL | |X | |X
|MODIFY | | |X |X |X
|MODULE | | |X | |X
|MONITOR |MON | |X |X |X
|MSDBLOAD | | |X | |
|MSG |MESSAGE | |X | |X
|MSGAGE | | |X | |X
|MSNAME | | |X | |X
|MSPLINK | | |X | |X
|MULTSIGN | | |X | |X
|NOBACKOUT |NOBKO | |X |X |
|NOBMP | | |X |X |X
|NOBUILDQ |NBLDQ, NOBLDQ | |X | |X
|NOCHECK | | |X |X |
|NOCMDAUTH | | |X | |X
|NOCMDAUTHE | | |X | |X
|NOCOMP | | |X |X |
|NOCQSSHUT | | | |X |
|NODBALLOC | | |X |X |
|NODE | | |X | |X
|NOFEOV | | |X |X |
|NOOPEN | | |X |X |
|NOPASSWORD |NPSWD | |X |X |X
|NOPFA | | |X |X |
|NOREVERSE | | |X |X |X
|NOSAVE | | |X | |X
|NOSHUT |NOS | |X | |X
|NOTERMINAL |NOTER, NOTERM | |X | |X
|NOTRANAUTH | | |X | |X
|NOTRANCMDS | | |X | |X
|NOTRDY | | |X | |X
|NOUSER | | |X | |X
|NPRI | | |X | |X
|OASN | | |X |X |X
|OFFLINE | | |X |X |
|OLC | | |X |X |X
|OLDS | | |X |X |X
|OLREORG | |OLREORG | | |
|OPEN | | |X |X |
|OPTION | | |X |X |X
|OSAMGTF | | |X |X |
|OTMA | | |X | |X
|OUTBND |OUTBOUND | |X |X |X
|OUTPUT | | |X | |X
|OVERFLOWQ |OFLWQ |OVERFLOWQ |X | |X
|OVERRIDE |OVER | |X |X |X
|PARLIM | | |X | |X
|PASSWORD |PASSWORDS, PSWD, PSWDS |PSWD |X |X |X
|PCH | | |X | |X
|PDS | | |X |X |X
|PI | | |X |X |
|PITR | | |X |X |
|PLMCT |PLCT |PLCT |X | |X
|POOL | | |X |X |X
|PREPARE | | |X |X |X
|PRIORITY |PRTY | |X | |X
|PROGRAM |PGM, PGMS, PROG, PROGRAMS, PROGS |PGM |X |X |X
|PRT | | |X | |X
|PRTKN |PRK | |X |X |
|PSB | | |X |X |X
|PTERM |PTERMS |PTERM |X | |X
|PURGE | | |X |X |X
|PURGE1 |FIRST, SINGLE, SNGL | |X | |X
|Q |QS, QUEUE, QUEUES |Q |X | |X
|QCNT | | |X | |X
|QMGR | | |X | |X
|QUIESCE | | |X | |X
|RCVTIME | | |X |X |
|RCVTOKEN | | |X |X |
|RDR | | |X | |X
|READNUM | | |X |X |
|READY | | |X | |X
|RECOVERY |REC |RECOVERY |X |X |
|RECOVGRP |RCVGRP | |X |X |
|REGION |REGIONS, REG, REGS, |MSGREG, MSGREGS, MSGREGION, MSREGIONS, THREAD |REGION |X |X |X
|REMOTE | | |X | |X
|REMOVE |REM |REMOVE |X |X |
|RESET | | |X |X |X
|RTCODE |RTC |RTC |X | |X
|SAVE | | |X | |X
|SB | | |X |X |
|SCHD | | |X |X |X
|SEGNO | | |X | |X
|SEGSIZE |SEGSZ |SEGSZ |X | |X
|SERVGRP |SG |SERVGRP |X |X |X
|SET | | |X |X |X
|SHAREDQ |SHRQ |SHAREDQ |X | |X
|SHUTDOWN | | |X |X |X
|SIDE | | |X | |X
|SNAP | | |X |X |X
|SNAPQ | | |X | |X
|SNGLSIGN | | |X | |X
|SQTT | | |X | |X
|SSM |SUBSYSMEMBER | |X |X |X
|STAGLOBAL | | |X |X |
|STALOCAL | | |X |X |
|START |STA |START |X |X |
|STATISTICS | | |X |X |X
|STATUS | | |X |X |X
|STOP |STO |STOP |X |X |
|STRUCTURE |STRUC |STRUCTURE |X | |X
|SUBSYS |SUBSYSTEM, SUBSYSTEMS |SUBSYS |X |X |X
|SURVEILLANCE |SUR, SURV, SURVEIL |SURV |X | |X
|SUSPEND | | |X | |X
|SYNCLEVEL |SYNCLV | |X | |X
|SYNCSESS |SYNC | |X | |X
|SYSID | | |X | |X
|SYSTEM | | |X | |X
|TABLE | | |X |X |X
|TAKEOVER |TKO, TKOVR | |X | |X
|TCO | | |X | |X
|TDS | | |X | |X
|TERMINAL |TER, TERM, TERMINALS, TERMS, |TERS |TERMINAL |X | |X
|THREAD | | |X |X |
|TIMEOUT |TIMO | |X | |X
|TIMEOVER | | |X | |X
|TMEMBER |TMEM |TMEM |X | |X
|TPIPE |TPI | |X | |X
|TPNAME |TP, TPN | |X | |X
|TRACE | | |X |X |X
|TRACKING | | |X |X |X
|TRACKING STATUS | | |X |X |X
|TRANAUTH | | |X | |X
|TRANCMDS | | |X | |X
|TRANSACTION |TRANS, TRAN, TRANSACTIONS, TRANCODE, TRANCODES, |TRS |TRAN |X | |X
|TRAP | | |X | |X
|TRKAUTOARCH |TRKARCH |TRKARCH |X |X |X
|TRS | | |X |X |X
|TYPE | | |X | |X
|UDATA | | |X | |X
|UDS | | |X | |X
|UNITYPE | | |X | |X
|UNPLAN | | |X |X |X
|UOR | | |X |X |
|USEDBDS |USEAREA | |X |X |
|USER |SUBPOOL |USER |X | |X
|USERD |USRD | |X | |X
|USERID | | |X |X |X
|VGRS |VGR |VGR |X | |X
|VID | | |X | |X
|VOLUME | | |X |X |X
|VTAMPOOL |VPL | |X | |X
|WADS | | |X |X |X
|WPM1 | | |X | |X
|WPM2 | | |X | |X
|WPM3 | | |X | |X
|XRCTRACK | | |X |X |X
|XTRC |XTRACE, EXTRACE | |X |X |X
| | |
Notes:
|
|

1 ISOLOG and TRKAUTOARCH |are valid only for an RSR tracking subsystem.

ABDUMP
Requests abnormal termination and a dump of the following:

ABDUMP is also valid with /STOP BACKUP, when it is used to request abnormal termination and a dump of the backup system.

ABORT
Is used with the /MODIFY command to terminate an online change process. This keyword prevents the libraries from being switched and resets the QSTOP status for transactions. ABORT is also used with /CHANGE CCTL or /CHANGE UOR to back out changes for a unit of recovery.
ACCESS
Is used with the /START DATABASE command to indicate the type of access intended for the named database. This keyword overrides the database access specified at system definition.
ACTIVE
Refers to IMS resources currently in use with the following commands:
ADS
Is used with the /STOP command to refer to an area data set.
AFFINITY
Is used with the /DISPLAY command to display VTAM affinities that the IMS subsystem has with specific nodes.
ALLENTRIES
Is used with the following commands:
AOITOKEN
Is used with the following commands:
APDB
Is used with the /TRACE MONITOR command to monitor activity between application programs and databases, including Fast Path activity.
APMQ
Is used with the /TRACE MONITOR command to monitor activity between application programs and message queues, including Fast Path activity.
APPC
Is used with the following commands:
AREA
Refers to the areas of a data entry database (DEDB). Areas are data sets that contain entire physical records. AREA is used with the following commands:
ASR
Is used with the /CHANGE LINK and /CHANGE NODE commands to change the automatic session restart designation of a link or node.
ASSIGNMENT
Is used with the /DISPLAY command to refer to resource assignments.
AUTO
Is used with the /TRACE SET ON TIMEOUT command to support the IMS VTAM I/O Timeout facility. The AUTO keyword automatically issues a message along with VTAM INACT and VTAM ACT commands to attempt activation of a node, if I/O exceeded the timeout value specified in the /TRACE command.
AUTOARCH
Is used with the /START and /STOP commands to start and stop automatic archiving of online log data sets.
AUTOLOGON
Is used with the following commands:
BACKUP
Is used with the following commands:
BALGRP
Is used with the /DISPLAY QUEUE and /DISPLAY QCNT commands to display statistical information about the Fast Path balancing group queues.
BKERR
Is used with the /DISPLAY DATABASE command to display error queue elements associated with a DL/I or DEDB database. It also displays incomplete backouts preventing the use of a DL/I database.
BUILDQ
Is used with the /NRESTART and /ERESTART commands to request reconstruction of the message queue data sets.
CAGROUP
Is used with the following commands:
CANCEL
Is used with the /STOP REGION command to cancel a message region, and it is only valid after a /STOP REGION ABDUMP command. It is also used with the /STOP APPC command to cause APPC/z/OS to initiate a shutdown sequence.
CCTL
Is used in /DISPLAY CCTL or /CHANGE CCTL to represent a CICS(R) subsystem that is connected to a DBCTL or IMS subsystem.
CHECKPOINT
Is used with the following commands:
CLASS
|Is used with the /ASSIGN, /START, and /STOP commands to indicate that the specified command will affect |the class-scheduling capability of IMS. /DISPLAY STATUS CLASS displays the status of classes. Valid parameters are one |or more decimal numbers from 1 through 999 that represent class |numbers assigned during IMS system definition. | |

This keyword is also used with /DISPLAY QUEUE, /PSTOP TRANSACTION, and /PURGE TRANSACTION.

CMDAUTH
Is used with the /ERESTART and /NRESTART commands to specify that both signon (user identification verification) and command authorization for static and ETO terminals are in effect at the end of the emergency restart.
CMDAUTHE
Is used with the /ERESTART and /NRESTART commands to specify that command authorization for ETO terminals (same as RCF=S on the startup parameter) is in effect at the end of the emergency restart. CMDAUTHE also resets command authorization for static terminals, if it was set.
CNS
Is used with the /COMPT and /RCOMPT commands to notify IMS that the console component is either operable or inoperable.
COLDBASE
Is used with the /ERESTART command to cold start the database component of IMS.
COLDCOMM
Is used with the /ERESTART command to indicate a data communication cold start.
COLDSESS
Is used with the /CHANGE LINK and /CHANGE NODE commands. COLDSESS is used with the /CHANGE LINK to reset the specified link or links. Use this keyword only after the /PSTOP command has been issued and completed against the link or links.

COLDSESS is used with the /CHANGE NODE command to set up the SLU P or FINANCE session so that the session can be cold started.

COLDSYS
Is used with /ERESTART to cold start both the database component and data communications components of IMS.
COMMIT
Is used to make the changes indicated by the /MODIFY PREPARE command or the INITIATE OLC PHASE(PREPARE) command. This keyword is also used with /CHANGE CCTL or /CHANGE UOR to commit changes for a unit of recovery.
COMP
Is used with the /TRACE SET PSB command to generate program communication block (PCB) and data compare statement images.
COMPONENT
Is used with the /ASSIGN command to refer to an output component member of a physical terminal complex. Valid parameters are numeric values from 1 through 4.
CONTINUOUS
Is used with the /RSTART LINK command to keep the link running by sending dummy data blocks when there is no data to be sent.
CONVERSATION
Is used only in IMS systems using conversational processing with the following commands:
CPLOG
Is used with the /DISPLAY command to display the value of the IMS execution parameter, CPLOG. The CPLOG keyword is also used with the /CHANGE command to change the value of the CPLOG IMS execution parameter. The CPLOG parameter specifies the number of log records written between system-generated checkpoints.
CPRI
Is used with the /ASSIGN command to refer to the current priority of a transaction code. The current priority of a transaction code is the current priority at which the transaction is scheduled. Valid parameters are 1- or 2-character numeric priorities, from 0 through 14.
CQS
Is used with the /DISPLAY command to display information about the IMS Common Queue Server subsystem that manages the IMS shared queues.
CRD
Is used with the /COMPT and /RCOMPT commands to notify IMS that the card component is operative or inoperative.
DATABASE
Refers to a database. Valid parameters are database names consisting of 1 to 8 alphanumeric characters. DATABASE is used with the following commands:
DATAGROUP
Refers to groups of DL/I databases and Fast Path DEDBs to be processed. Data groups are logical groupings of databases and areas; they allow simplified command processing for the databases and areas. DATAGROUP is used with the following commands:

DATAGROUP is valid on active and RSR tracking subsystems.

| |
DATAGRP
|
Refers to groups of DL/I databases and Fast Path DEDBs to |be processed within an IMSplex. DATAGRP is used with the following |commands: | | |
| |
DB
|
Refers to a database to be processed within an IMSplex. DB |is used with the following commands: | | |
DBALLOC
Is used with the /START DATABASE and /START DATAGROUP commands to indicate that databases will be allocated. If not specified, DBALLOC is the default for /START DATABASE 'dbname' commands only. For /START DATABASE ALL and /START DATAGROUP commands, the default is NODBALLOC. This keyword is not allowed on the RSR tracking system.
DBD
Is used with the /DISPLAY command, if Fast Path is installed, to display Fast Path and IMS databases, the PSBs that access them, and the type of access.
DBDS
Is used with the following commands:
DBDSGRP
Is used with the following commands:
DBS
Is used with the /DISPLAY MODIFY command to display databases or areas with work in progress that could prevent an online change from succeeding.
DC
Is used with the /START command to initiate IMS data communication processing, including processing VTAM logons. DC is used with the /STOP command to prohibit logging on to VTAM. DC is also used with /DISPLAY ACTIVE to show VTAM ACB status, as well as line and node activity.
DESCRIPTOR
Is used with the /CHANGE, /DELETE, and /DISPLAY commands to alter, delete, or show the LU 6.2 descriptor values. Valid parameters are from 1 to 8 alphanumeric characters long.
DIRECTORY
Is used with the /CHANGE command to restore the MFS Dynamic Directory back to its status after initialization.
DONE
Is used with the /IAM command to disconnect a terminal on a switched line from IMS.
DUMPQ
Is used with the /CHECKPOINT command to request that termination of IMS include DUMPQ functions.

DUMPQ is also used with the /RTAKEOVER command on an active subsystem for a planned RSR takeover. /RTAKEOVER DUMPQ indicates that a /CHECKPOINT DUMPQ type of shutdown is performed before the planned takeover occurs.

EMHQ
Causes global queue count information to display on the Expedited Message Handler queue (EMHQ) when both EMHQ and QCNT are specified. EMHQ is used with the following commands:
ERRORABORT
Is used with the /RECOVER START command and specifies that recovery will stop for all entries in the recovery list if any database data set or area is unable to complete recovery.
ERRORCONT
Is used with the /RECOVER START command and specifies that recovery is to continue if any database data set or area is able to complete recovery.
EXIT
Is used with the /DISPLAY TRACE and /TRACE EXIT commands and displays user exit tracing. Currently, only tracing for the DFSMSCE0 user exit is supported.
FDR
Is used with the /CHANGE and /DISPLAY commands to change or display information for IMS Fast Database Recovery regions.
FORCE
Is used with the /SWITCH command to cause immediate termination of the active system in an XRF environment.

FORCE is used with the /PSTOP command for VTAM links and is intended to be used when an MSC VTAM link will not cleanup and idle during normal PSTOP processing, even though VTAM has terminated the session.

FORCE also can be used in conjunction with some VTAM commands to idle and cleanup the VTAM link within IMS, so that a /RSTART LINK can be issued to restart the link again.

FORCE is also used with the /CLSDST command to re-initialize a hung node with I/O in progress.

FORCSESS
Is used with the /CHANGE command to allow session though message resynchronization was not successful. This change remains in effect until the next /CHANGE command or IMS cold start and overrides the FORCSESS/SYNCSESS specification on the TERMINAL or MSLINK macro. FORCSESS is valid for multiple system coupling (MSC) VTAM or Intersystem Communication (ISC).
FORMAT
Is used with /NRESTART and /ERESTART commands to request reformatting of one or more system data sets. Valid parameters are 2-character data set identifications.
FPPROG
Is used with the /PURGE command to terminate Fast Path message-driven programs by PSB name.
FPREGION
Is used with the /PURGE command to specify the region identifier of the message-driven programs to be terminated.
FPVIRTUAL
Is used with the /DISPLAY command to show DEDB areas loaded into z/OS data spaces for the Fast Path Virtual Storage Option (VSO). FPVIRTUAL is valid only on active DB/TM and DBCTL subsystems.
FREEZE
Is used with the /CHECKPOINT command to request termination of IMS.

FREEZE is also used with the /RTAKEOVER command on an active subsystem for a planned RSR takeover. /RTAKEOVER FREEZE indicates that a /CHECKPOINT FREEZE type of shutdown is performed before the planned takeover occurs.

GLOBAL
Is used with the /DBDUMP, /DBRECOVERY, /START, and /STOP commands to specify that the command applies to all subsystems sharing a database.
GRSNAME
Is used with the /START VGRS command to specify a VTAM generic resource name for an IMS subsystem when it joins a generic resource group.
HSB
Is used with the /DISPLAY command to show XRF related information.
HSSP
Is used with the /DISPLAY command to display high speed sequential processing (HSSP) information.
ICOMPONENT
Is used with the /ASSIGN command to refer to an input component number of a physical terminal complex. Valid parameters are numbers 1 through 4.
ID
Is used with the /OPNDST NODE USER command to identify the other system half-session qualifier.
IMS PLEX
Is used with the IMSplex commands to refer to an IMSplex in a Parallel Sysplex(R) environment.
INDOUBT
Is used with the /DISPLAY CCTL command to show in-doubt threads.
INPUT
Is used with the following commands:
INTERVAL
Is used with the /CHANGE SURVEILLANCE command to change the interval value of a particular surveillance mechanism in an XRF environment. The interval value controls how often the alternate system surveys the state of the active system.
ISOLOG
Is used with the /START command on an RSR tracking subsystem to request isolated log data (a gap in the log data) from the isolated log sender at the active site.

The ISOLOG keyword is valid only on an RSR tracking subsystem.

JOBNAME
Is used with the following commands to specify the job name on the JOB statement of a region's JCL member:
LA
Is used with the /TRACE MONITOR command to monitor line and logical link events.
LE
Is used on DELETE, UPDATE, and QUERY commands to specify Language Environment(R) (LE) runtime parameter overrides.
LEAVEPLEX
In an IMSplex, this keyword is specified if the IMS that is being shut down is not going to rejoin the IMSplex. Specify the LEAVEPLEX keyword when you do not intend to bring the IMS back up in the IMSplex.
LEAVEGR
Is used with the /CHECKPOINT command to delete all affinities from the VTAM affinities table for an IMS subsystem during IMS shutdown. This keyword also causes IMS to leave the VTAM generic resources group.
LEVEL
Is used with the /TRACE command to indicate the extent of desired trace information. Valid parameters are numeric values from 1 through 4.
LINE
Refers to a communication line. Valid parameters are line numbers that are 1 to 4 characters long.

LINE is used with the following commands:

/ASSIGN           /LOOPTEST
/BROADCAST        /MONITOR
/DELETE PASSWORD  /PSTOP
/DEQUEUE          /PURGE
/DISPLAY          /RSTART
/END              /START
/EXCLUSIVE        /STOP
/EXIT             /TEST MFS
/IDLE             /TRACE
LINK
Refers to a logical link in a multiple systems configuration. Valid parameters are numbers 1 through 255.

LINK is used with the following commands:

/ACTIVATE         /MSASSIGN
/CHANGE           /PSTOP
/DISPLAY          /RSTART
/IDLE             /TRACE
LMCT
Is used with the /ASSIGN command to refer to the limit count of a transaction code. The limit count is the queue count number for which the current priority is changed to the limit priority. Valid parameters are numeric values from 1 through 65535.
LOCAL
Is used with the /DBDUMP, /DBRECOVERY, /MSASSIGN TRANSACTION, /START, and /STOP commands to specify that the command applies only to the subsystem in which the command is issued.
LOGOND
Is used with the /OPNDST command to indicate the logon descriptor used for session establishment for dynamic terminals.
LOPEN
Is used with the /RSTART LINE command to enable communication lines again when the next I/O operation occurs.
LPRI
Is used with the /ASSIGN command to refer to the limit priority of a transaction code. The LPRI is the priority to which this transaction is raised if the queue count is equal to, or exceeds, the limit count. Valid parameters are 1- or 2-character numeric priorities, from 0 through 14.
LTERM
Refers to a logical terminal. Valid parameters are logical terminal names consisting of 1 to 8 alphanumeric characters. The LTERM can be defined to IMS in the system definition or it can be dynamically introduced if ETO is enabled.

This keyword is used with the following commands:

/ASSIGN           /MODIFY
/BROADCAST        /PSTOP
/DELETE           /PURGE
/DEQUEUE          /RMxxxxxx
/DISPLAY          /SET
/FORMAT           /START
/IAM              /STOP
/LOCK             /UNLOCK

LTERM is also used with IMSplex commands.

LUNAME
Refers to the logical unit name of an LU 6.2 application program or destination. A network-qualified LU name is optional on the LUNAME keyword. A network-qualified LU name is 1 to 8 alphanumeric characters long (the network identifier of the originating system), followed by a period, and then followed by the LU name that is also 1 to 8 alphanumeric characters long. IMS commands that include network-qualified LU names must enclose the network-qualified LU name in single quotes; for example, 'NETID001.LUAPPC02'. No blanks are allowed in a network-qualified LU name.

An LU name that is not network-qualified consists of 1 to 8 alphanumeric characters.

This keyword can be used with the following commands:

/ALLOCATE           /START
/CHANGE DESCRIPTOR  /STOP
/DEQUEUE            /TRACE
/DISPLAY
MADSIOT
Is used with the following commands:
MASTER
Is used with the /BROADCAST, /DISPLAY, /RDISPLAY, and /SMCOPY commands to issue commands to or receive information from the IMS master terminal.
MAXRGN
Is used with the /CHANGE TRANSACTION command to change the maximum number of regions that can be simultaneously scheduled for a given transaction.
MEMBER
Is used with the QUERY command to refer to IMSplex components in an IMSplex.
MODE
Is used with the /ALLOCATE, /CHANGE DESCRIPTOR, /DISPLAY, /OPNDST, and /RSTART LINK commands to refer to the various modes in which VTAM terminals can operate. The mode parameter causes selection of the corresponding entry in the VTAM LOGON MODE table.
MODIFY
Is used with the /DISPLAY command to indicate the status of the resources to be deleted or changed.
MODULE
Is used with the /TRACE command to indicate the calls to trace. Valid parameters are DDM, MFS, and ALL.
MONITOR
Is used with the /TRACE command to activate the IMS Monitor. Valid parameters are LA, SCHD, APMQ, APDB, and ALL. MONITOR is also used with the /DISPLAY TRACE command.
MSDBLOAD
Is used with the /NRESTART command during warm starts to load MSDBs from the z/OS sequential data set MSDBINIT.
MSG
Is used with /TRACE SET ON TIMEOUT to support the IMS VTAM I/O Timeout facility. The MSG keyword is used with /TRACE SET ON TIMEOUT to issue a message when I/O has exceeded the timeout value specified in the /TRACE command.
MSGAGE
Is used with /DISPLAY QCNT command to display a count of messages in a shared queue in which the oldest message exceeds the specified message age (in days).
MSNAME
Is used with the following commands to refer to a logical link path in a multiple systems configuration:
MSPLINK
Is used with the following commands to refer to a physical link in a multiple systems configuration:
MULTSIGN
Is used with the /ERESTART and /NRESTART commands to permit multiple signons for each user ID. It also indicates user identification verification is in effect at the end of emergency restart.
NOBACKOUT
Is used with the /START DATABASE command to suppress backout restart for a database not registered in DBRC.
NOBMP
Is used with the /ERESTART command to prevent backout of updates made by batch message processing programs active when the system failure occurred.
NOBUILDQ
Is used with the /NRESTART command to allow IMS to come up quickly when queues are reformatted.
NOCHECK
Is used with the /RECOVER START command. If a member of a recovery group is in the recovery list being started, NOCHECK specifies that the Online Recovery Service will not stop a timestamp recovery or a timestamp recovery to any prior point in time (PITR) if one of the following situations occurs:
NOCMDAUTH
Is used with the /ERESTART and /NRESTART commands to reset command authorization on static and ETO terminals.
NOCMDAUTHE
Is used with the /ERESTART and /NRESTART commands to reset command authorization for static and ETO terminals. The command authorization is reset for static terminals because the command authorization for static terminals cannot exist without the command authorization for ETO terminals.
NOCOMP
Is used with the /TRACE SET PSB command to suppress PCB and data compare statement images.
NOCQSSHUT
Is used with the /CHE DUMPQ, /CHE FREEZE, or /CHE PURGE commands to not shut down the CQS address space when the IMS control region terminates. The CQS address space remains active and connected to the message queue structures. NOCQSSHUT is applicable only when IMS is running in a shared-queues environment. The default is to shut down the CQS address space when the IMS control region terminates.
NODBALLOC
Is used with the /START DATABASE and /START DATAGROUP commands to indicate that databases are not to be allocated. This is the default for /START DATABASE ALL and /START DATAGROUP commands. For /START DATABASE 'dbname' commands, the default is DBALLOC, and NODBALLOC must be specified if the database is not to be allocated. If not allocated, the database will be allocated when it is scheduled. This keyword is not allowed on the RSR tracking system.

NODBALLOC is valid only on an active subsystem.

NODE
Refers to a valid VTAM node. The node can be defined to IMS through system definition or dynamically introduced if ETO is enabled. If the NODE parameter is associated with ISC parallel sessions, the USER keyword should be used to specify the proper half-session. When the USER keyword is omitted, all half-sessions of the specified node are affected by the command.

When the NODE and USER keywords are both used, the USER keyword must follow the NODE keyword. For restrictions on the use of NODE USER keyword combinations, see Commands with the NODE USER Keyword Combination

NODE is used with the following commands:

/ACTIVATE           /EXIT
/ASSIGN             /IDLE
/BROADCAST          /LOCK
/CHANGE             /OPNDST
/CLSDST             /QUIESCE
/COMPT              /RSTART
/DELETE PASSWORD    /START
/DEQUEUE            /STOP
/DISPLAY            /TEST MFS
/END                /TRACE
/EXCLUSIVE          /UNLOCK

NODE is also used with IMSplex commands.

Several commands that affect NODEs are valid only for static terminals. These commands are valid only for static nodes:

The following commands are valid for static nodes with ISC parallel sessions:

NOFEOV
Is used with the /DBDUMP and /DBRECOVERY commands to allow the commands to execute without forcing end-of-volume on the system log.
NOOPEN
Is used with the /START DBcommand to indicate that the named database should not be opened in the processing of this command.
NOPASSWORD
Is used with the /NRESTART command to negate the password security specifications of the IMS Security Maintenance utility.
NOPFA
Is used with the following commands to specify that DBRC is not to be notified of a change in status for a database or area:

By using this keyword, DBRC does not prevent further authorizations for the database or area.

NOREVERSE
Is used with the /RTAKEOVER UNPLAN command to specify that an unplanned remote takeover cannot be reversed. The primary effect of this keyword is that the IMS tracking subsystem saves and processes all data it has received from an active site, regardless of whether that data was committed.
NOSAVE
Is used with the following commands:
NOSHUT
Is used with the /IDLE LINE command to stop input and output activities on 3270 remote BTAM lines without having to initiate a checkpoint shutdown. NOSHUT is not valid with the /IDLE NODE command.
NOTERMINAL
Is used with the /NRESTART command to negate the terminal security specifications of the IMS Security Maintenance utility.
NOTRANAUTH
Is used with the /ERESTART and /NRESTART commands to turn off transaction authorization. NOTRANAUTH is not the opposite of TRANAUTH. TRANAUTH sets transaction authorization and also turns on signon (user identification verification).
NOTRANCMDS
Is used with the /ERESTART and /NRESTART commands to negate transaction command security.
NOTRDY
Is used with the /COMPT and /RCOMPT commands to make a terminal component not ready.
NOUSER
Is used with the /NRESTART command to request that neither security authorization nor transaction authorization be in effect at the end of the normal restart.
NPRI
Is used with the /ASSIGN command to refer to the normal priority of a transaction code. The normal priority is assigned to the transaction as the current priority when the transaction queue count is less than the limit count. Valid parameters are 1- or 2-character numeric priorities from 0 through 14.
OASN
Is used with the /CHANGE and /DISPLAY commands to specify a specific outstanding recovery element related to an external subsystem being deleted from IMS. The origin application schedule number (OASN) is used by IMS to identify recovery information.
OFFLINE
Is used with the following commands:
OLC
Is used with the INITIATE, QUERY, and TERMINATE commands to initiate, query, or terminate a global online change.
OLDS
Is used with the /DISPLAY, /START, /STOP, and /SWITCH commands to refer to online log data sets.
| |
OLREORG
|
Is used with the INITIATE, /INITIATE, QUERY, /QUERY, TERMINATE, /TERMINATE, UPDATE, and /UPDATE commands to initiate, query, terminate, or update an online reorganization |of a HALDB partition. |
OPEN
Is used with the /START DBcommand to indicate that the named database should be opened in the processing of this command.
OPTION
Is used with the /TRACE command. When used with the PI keyword, OPTION indicates a request for a specific program isolation trace option. Valid parameters are LOG, TIME, and ALL. When used with the TABLE keyword, OPTION indicates whether or not the trace tables will be logged.
OSAMGTF
Is used with the /TRACE command to activate or deactivate tracing of GTF trace records for every OSAM buffer request of LOCATE or CREATE.

OSAMGTF keyword is also used with the /DISPLAY TRACE command to display whether the OSAM Buffer Trace facility is active or inactive.

OTMA
Is used with the /DISPLAY, /START, and /STOP commands to display, start, or stop IMS Open Transaction Manager Access (OTMA). OTMA is also used with the /SECURE command to control the RACF security level for OTMA.
OUTBND
Is used with the /CHANGEcommand to change the current outbound LU.
OUTPUT
Is used with the /ASSIGN command to change a logical terminal output assignment without changing the input assignment.

OUTPUT is also used with the following commands:

OVERFLOWQ
Is used with the /DISPLAY command to display queues on an overflow list structure in a shared-queues environment.
OVERRIDE
Is used with the /ERESTART command to restart the system after failure of power, machine, z/OS, or DBRC.
PARLIM
Is used with the /ASSIGN command when message regions are parallel processing a transaction. PARLIM is the maximum number of messages that can be enqueued, but not yet processed, by each active message region currently scheduled for this transaction. An additional message region is scheduled whenever the transaction queue count exceeds the PARLIM value multiplied by the number of regions currently scheduled for this transaction (for shared queues environments, the successful consecutive GU count is used instead of the queue count). Valid parameters are numeric values from 0 through 32767, and 65535, where 65535 disables transaction load balancing.
PASSWORD
Refers to the password security specifications of the IMS Security Maintenance utility. PASSWORD is used with the following commands:
PCH
Is used with the /COMPT and /RCOMPT commands to notify IMS that a punch component is either operable or inoperable.
PDS
Is used with the /COMPT and /RCOMPT commands to notify IMS that a print data set is operable or inoperable.
PI
Is used with the /TRACE command to request that program isolation be traced along with all calls to ENQ/DEQ and the DL/I buffer handler. PI is also used with the /DISPLAY TRACE command to display the status of the program isolation trace.
PITR
Is used with the /RECOVER START command and specifies that timestamp recovery (TSR) was specified or a point-in-time recovery is to be performed against the database data sets and areas specified with preceding /RECOVER ADD commands.
PLMCT
Is used with the /ASSIGN command to refer to the processing limit count of a transaction code. The processing limit count is the number of messages of this transaction code that a program can process in a single scheduling. Valid parameters are values from 0 through 65535.
POOL
Is used with the /DISPLAY command to refer to a buffer pool within the IMS system. Valid parameters are 3- and 4-character pool names.
PREPARE
Is used with the /MODIFY and INITIATE OLC commands to initiate the prepare phase to change resources online. These commands refer to local online change or global online change.
PRIORITY
Is used with the /DISPLAY Q command to request transaction scheduling information, such as queue count, class, and current priority.
PROGRAM
PROGRAM refers to an IMS application program. PROGRAM is used with the following commands:
/DELETE
/DISPLAY
/LOCK
/START
/STOP
/TRACE
/UNLOCK

Valid parameters are program names that are 1 to 8 alphanumeric characters long.

Use of the ALL parameter for /DISPLAY PROGRAM can be prevented by specifying ALL=NO on the KEYWD macro. For more information on the KEYWD macro, see IMS Version 9: Customization Guide.

PRT
Is used with the /COMPT and /RCOMPT commands to notify IMS that a printer component is either operable or inoperable.
PRTKN
Indicates the pseudo recovery token to be used with the /CHANGE CCTL command.
PSB
Is used with the /DISPLAY command if Fast Path is installed, to display Fast Path and IMS PSBs, the transactions they are processing, the databases they are accessing, and any Fast Path routing codes associated with the transactions.

This keyword is also used with the /TRACE command to record all DL/I calls issued for a specified PSB.

PTERM
Is used with the commands listed below to refer to a relative physical terminal:
/ASSIGN             /LOOPTEST LINE
/BROADCAST          /MONITOR LINE
/DELETE PASSWORD    /PSTOP LINE
/DEQUEUE            /PURGE LINE
/DISPLAY            /RSTART LINE
/END LINE           /START LINE
/EXCLUSIVE LINE     /STOP LINE
/EXIT LINE          /TEST MFS LINE
/IAM                /UNLOCK
/LOCK

Valid parameters are numbers corresponding to the relative position of the terminal on the line. When used without the LINE keyword on the /DISPLAY command, valid parameters are physical terminal attributes.

PURGE
Is used with the following commands:
PURGE1
Is used with the /DEQUEUE command to delete only the first message currently queued to an LTERM.
Q
Is used with the /DISPLAY command to request message queue information. The keyword is also valid with /OPNDST NODE to request VTAM to queue SIMLOGON requests for VTAM/SNA-supported terminals.
QCNT
Is used with the following commands to display the global count of messages in a shared-queues environment:

With this keyword, local queue counts are not displayed; any numbers displayed for local queue counts should be ignored.

QMGR
Is used with the /TRACE TABLEcommand to indicate that the queue manager trace is to be activated or deactivated.
QUIESCE
Is used with the /CHECKPOINT command to shut down the network only after normal processing is complete on all VTAM nodes.
RCVTIME
Is used with the /RECOVER REMOVE and /RECOVER START commands to specify a recovery to a point in time.
RCVTOKEN
Is used with the following commands:
RDR
Is used with the /COMPT and /RCOMPT commands to notify IMS that a reader component is either operable or inoperable.
READNUM
Is used with the /RECOVER REMOVE and /RECOVER START commands to specify the number of input devices used in parallel during recovery.
READY
Is used with the /COMPT and /RCOMPT commands to make a terminal component ready.
RECOVERY
Is used in the /DISPLAY RECOVERY command to display the list of database data sets and areas being recovered by Online Recovery Service. Is also used with the /DISPLAY NODE RECOVERY or /DISPLAY USER RECOVERY commands to display status recovery settings for a node or user.
RECOVGRP
Is used with the /RECOVER ADD, /RECOVER REMOVE, and /RECOVER STOP commands to specify that the listed groups are recovery groups. A recovery group is a group of full-function databases or DEDB areas that are related.
REGION
Requests an action be taken with respect to a message processing region, batch message processing region, or Fast Path region.

REGION is used with the /ASSIGN, /DISPLAY ACTIVE, /PSTOP, /START, and STOP commands.

REMOTE
Is used with the /DISPLAY QCNT command to display remote LTERMs and remote transactions on shared queues.
REMOVE
Is used with the /RECOVER command to remove some or all database data sets and areas from the recovery list.
RESET
Is used with the /CHANGE command to indicate that an incomplete unit of work, identified by OASN and assigned to an external subsystem, will be deleted.
RTCODE
Refers to Fast Path routing codes and is used with the following commands:
SAVE
Is used with the following commands:
SB
Is used with the /START and /STOP commands to dynamically enable and disable the usage of sequential buffering.
SCHD
Is used with the /TRACE TABLE command to indicate that the scheduler trace is to be activated or deactivated.
SEGNO
Is used with the /ASSIGN command to specify the maximum number of application program output segments allowed into the message queues per Get-Unique (GU). Valid parameters are numbers 0 through 65535. The default value is 0.
SEGSIZE
Is used with the /ASSIGN command to specify the maximum number of bytes allowed for one output segment. Valid values are 0, 5, or greater than 5 to the maximum of 65535. The default value is 0.
SERVGRP
Is used with the /START or /STOP command to start or stop an RSR service group.

SERVGRP is valid on active and RSR tracking subsystems.

SET
Is used with the /TRACE command to indicate whether tracing of internal IMS events should be turned on or off. It is also used to start or stop the IMS Monitor.
SHAREDQ
Is used with the /CQCHKPT and /CQSET commands to specify the IMS shared queues.
SHUTDOWN
Is used with the /DISPLAY STATUS command to request the status of a shutdown-in-progress. Is also used with the /CQSET command to initiate a structure checkpoint when the IMS Common Queue Server shuts down.
SIDE
Is used with the /CHANGE DESCRIPTOR command to refer to the APPC/z/OS side information table entry name. The side information table entry contains default values for APPC conversation attributes such as LUNAME, TPNAME, or MODE.

Valid parameters are from 1 to 8 alphanumeric characters long.

| |
SNAP
|
Is used with the /DIAGNOSE command and captures storage information and writes information |to the OLDS as type X'6701' records. |
SNAPQ
Is used with the /CHECKPOINT command to dump the contents of the message queues to the system log tape without causing a shutdown of IMS.
SNGLSIGN
Is used with the /ERESTART and /NRESTART commands to permit a single signon for each user ID. It also indicates that user ID verification is in effect at the end of an emergency restart.
SQTT
Is used with the /TRACE TABLE command to indicate that the shared queues trace is to be activated or deactivated.
SSM
Is used with the /START SUBSYSTEM command to allow external subsystem connection processing to be started if the SSM= parameter is not specified on the IMS startup JCL.

SSM can have one parameter associated with it. The subsystem member name can have a maximum of four characters.

STAGLOBAL
Is used with the /RECOVER ADD and /RECOVER START commands. If IRLM is available, STAGLOBAL specifies that a /START DB or AREA command will be processed on all IMSs that have the databases and areas defined when recovery successfully completes.
STALOCAL
Is used with the /RECOVER ADD and /RECOVER START commands to specify that the databases and areas that have entries in the recovery list will be brought online only on the IMS that ran the recovery. However, database data sets and areas with OFFLINE or STAGLOBAL specified on /RECOVER ADD commands will not be brought online. STALOCAL is ignored if PITR is specified.
START
Is used with the /RECOVER command to begin recovery for all database data sets and areas specified in the preceding /RECOVER ADD with the same recovery token that was specified in /RECOVER START.
STATISTICS
Is used with the /CHECKPOINT command to generate statistics records that are used for performance measurements and tuning an IMS system. Is also used with the /CQQUERY command to display statistics for coupling facility list structures.
STATUS
Is used with the /DISPLAY command to request the status of one or more system resources that are in exceptional states. STATUS also can be used with the SHUTDOWN keyword to request status of a shutdown-in-progress, and with the TRACKING keyword to get the status of the tracking system in an RSR complex.
STOP
Is used with the /RECOVER command to stop recovery for some or all database data sets and areas in the recovery list.
STRUCTURE
Is used with the following commands to refer to a primary coupling facility list structure used by IMS for shared queues or a coupling facility structure used by RM for resources:
SUBSYS
Is used with the /CHANGE, /DISPLAY, /START, and /STOP commands to identify the subsystem name that the command action will affect.
SURVEILLANCE
Is used with the /CHANGE, /START, and /STOP commands to refer to the XRF surveillance function. During XRF surveillance, the active XRF IMS subsystem sends signals to the alternate system. From these signals, the alternate system learns that the active system is running satisfactorily. If these signals stop, then the alternate system knows that there might be a problem in the active system. The parameters used with the SURVEILLANCE keyword describe a particular surveillance mechanism:
LNK
ISC Link
RDS
Restart Data Set
LOG
System Log
SUSPEND
Is used with the /DEQUEUE command to reschedule all transactions that have been suspended.
SYNCLEVEL
Is used with the /CHANGE DESCRIPTOR command to refer to the APPC synchronous level. This level is either NONE or CONFIRM.
SYNCSESS
Is used with the /CHANGE command to force a message resynchronization when the session is initiated. This remains in effect until the next /CHANGE command or IMS cold start.

SYNCSESS, which overrides the FORCSESS/SYNCSESS specification on the TERMINAL macro or the MSPLINK macro, is valid for MSC VTAM links or ISC nodes.

SYSID
Is used with the /BROADCAST MASTER, /DISPLAY ASSIGNMENT, /MSASSIGN, and /MSVERIFY commands to refer to the system identification of a system in a multiple systems configuration.

SYSID is also used with the /DISPLAY TRANSACTION command to refer to the local or remote systems associated with the transaction. Valid values are from 1 through 255.

Each SYSID has an MSNAME. The MSNAME keyword can be used in place of the SYSID keyword.

SYSID TRANSACTION is used with the /DISPLAY command to refer to the IDs of the local and remote systems associated with the transaction.

SYSTEM
Is used with the /UNLOCK and /SWITCH commands to refer to an XRF capable IMS system. Is also used with the /CQCHKPT command to refer to an IMS Common Queue Server subsystem.
TABLE
Is used with the /TRACE command to start online tracing, which allows a given trace table to be started or stopped, and specifies which components should be traced in a common trace table. This keyword is also valid with /DISPLAY TRACE, which shows the status of table traces.
TAKEOVER
Is used with /TRACE LINK, /TRACE LINE, and /TRACE NODE to trace terminals during XRF takeover.
TCO
Is used with the /TRACE command to activate or deactivate tracing for the Time-Controlled Operation (TCO). TCO is also used with the /DISPLAY TRACE command to show whether the tracing for the TCO is active or inactive.
TDS
Is used with the /COMPT and /RCOMPT commands to notify IMS that a transmit data set is operable or inoperable.
TERMINAL
Refers to the terminal security specifications of the IMS Security Maintenance utility. TERMINAL is used with the following commands:
THREAD
Is used with the /STOP command to stop a CCTL thread.
TIMEOUT
Is used with the /CHANGE SURVEILLANCE command to change a timeout value of a particular surveillance mechanism in an XRF environment. The timeout value controls the length of time the alternate system allows to elapse without a positive signal from the active system before requesting takeover or informing the operator of the potential failure.

TIMEOUT is also used with the /TRACE SET command to start or stop the IMS VTAM I/O Timeout facility. /DISPLAY TRACE TIMEOUT displays the status of the Timeout facility.

TIMEOVER
Supports the IMS VTAM I/O Timeout facility. The TIMEOVER keyword is used with the /DISPLAY command to display the VTAM nodes that have been waiting for a VTAM response for a longer time than your installation has specified with the /TRACE SET ON TIMEOUT command.
TMEMBER
Is used with the /DISPLAY command to display IMS Open Transaction Manager Access (OTMA) client status. It is also used with the /DISPLAY STATUS command to display all OTMA transaction pipes that are stopped.

It is used with the /DEQUEUE command to dequeue messages associated with an OTMA transaction pipe.

It is used with the /START and /STOP commands to cause IMS to resume or suspend sending of output to OTMA clients.

It is used with the /TRACE SET and /DISPLAY TRACE commands to set and display traces for OTMA transaction pipes.

TPIPE
Is used with the /DISPLAY command to display IMS Open Transaction Manager Access (OTMA) client status.

It is used with the /DEQUEUE command to dequeue messages associated with an OTMA transaction pipe.

It is used with the /START and /STOP commands to cause IMS to resume or suspend sending of output to OTMA clients.

It is used with the /TRACE command to trace transaction pipe activity for OTMA clients.

To remove TPIPEs from the IMS memory, perform a COLD START or COLD COMM.

TPNAME
Refers to the TPNAME of an LU 6.2 application program or destination. When used with the LUNAME keyword, TPNAME must follow LUNAME.

With any command other than /CHANGE DESCRIPTOR, a TPNAME parameter of DFSSIDE can be used to indicate that the specified LUNAME parameter represents the APPC/z/OS side information entry name.

The TPNAME parameter can be up to 64 alphanumeric characters long.

This keyword can be used with the following commands:

/ALLOCATE           /START
/CHANGE DESCRIPTOR  /STOP
/DEQUEUE            /TRACE
/DISPLAY
TRACE
Is used with the /DISPLAY command to examine the status and options of the current IMS traces.
TRACKING
Is used with the /DISPLAY command to display the RSR tracking status on either the active or RSR tracking subsystem.

TRACKING is valid on active or RSR tracking subsystems.

TRACKING STATUS
Is used with the /DISPLAY TRACKING STATUS command to display the status of a tracking subsystem.
TRANAUTH
Is used with the /ERESTART and /NRESTART commands to specify both the transaction authorization and user identification, with or without RACF, that will be in effect at the end of the restart.
TRANCMDS
Is used with the /ERESTART and /NRESTART commands to request that transaction command security be in effect at the end of the restart.

TRANCMDS is also used with the /MODIFY PREPARE command to add transaction command security.

TRANSACTION
Refers to a transaction code. Valid parameters are from 1 to 8 alphanumeric characters long.

This keyword is used with the following commands:

/ASSIGN          /PURGE
/CHANGE          QUERY
/DELETE          /SET
/DEQUEUE         /START
/DISPLAY         /STOP
/LOCK            /TRACE
/MSASSIGN        /UNLOCK
/PSTOP               UPDATE
TRAP
Is used with the /TRACE command to enable certain MFS serviceability enhancements. TRAP is also used with /DISPLAY TRACE to show the status of the trap trace.
TRKAUTOARCH
Is used to indicate that the RSR tracking system is to initiate a request to start the automatic archiving of the tracking log data sets. TRKAUTOARCH allows the user to start automatic archive after automatic archive has been terminated following archive data set full conditions.
TRS
Is used with the /DISPLAY MODIFY command to display transactions with work in progress that could prevent an online change from succeeding.
TYPE
Is used with the /CHANGE DESCRIPTOR command to refer to the APPC conversation type, which is either BASIC or MAPPED.
UDATA
Is used with the /OPNDST command to indicate the user data used with the logon. (The format of keyword and data: UDATA user data). The user data can include a logon descriptor name, a signon descriptor name, resource access control facility (RACF) access and authorization data, and user information used by a user exit.
UDS
Is used with the /COMPT and /RCOMPT commands to notify IMS that a user data set is operable or inoperable.
UNITYPE
Is used with the /TRACE command to trace all terminals of a specific type.
UNPLAN
Is used with the /RTAKEOVER command to specify an unplanned remote takeover. UNPLAN is valid only on the RSR tracking subsystem.
UOR
Is used with the /DISPLAY and /CHANGE commands to determine and specify units of recovery involved in protected conversations using RRS/z/OS.
USEDBDS
Is used with the /RECOVER ADD command and specifies that Online Recovery Service will not restore database data sets or areas specified in the command with image copies.
USER
A user can be a person signed onto a terminal or an ISC subpool. The USER keyword is used with:

Table 14 shows the commands that support the USER keyword. It also includes commands that support the USER keyword for dynamic users only.

Table 14. Commands That Support the USER Keyword
Commands Commands for Dynamic Users Only
/ASSIGN
/BROADCAST /BROADCAST USER
/CHANGE
/CLSDST
/COMPT
/DEQUEUE
/DISPLAY
/END /END USER
/EXCLUSIVE /EXCLUSIVE USER
/EXIT /EXIT CONVERSATION USER
/NRESTART
/OPNDST
/QUIESCE
/RSTART /RSTART USER
/START
/STOP
/TEST /TEST MFS USER
/TRACE
USERD
Is used with the /OPNDST command to indicate the user descriptor used with the signon.
USERID
Is used in the DELETE LE, QUERY LE, and UPDATE LE commands. It is used as a filter to add, delete, or display entries in the Language Environment (LE) runtime parameter override table.
VGRS
Is used with the /START and /STOP commands to cause IMS to join or leave a VTAM generic resources group. For the /START command, this keyword also allows you to specify the generic resource name if IMS does not already have one.
VID
Is used with the /COMPT and /RCOMPT commands to notify IMS that a display component is either operable or inoperable.
VOLUME
Is used with the /TRACE SET ON|OFF TABLE|PI command to specify the volume of tracing to be done: low, medium, or high.
VTAMPOOL
Is used with the /ASSIGN USER command to deallocate an entire string of LTERMs defined for a user.
WADS
Is used with the /START, /STOP, and /SWITCH commands to add a write-ahead data set (WADS) to the pool of available WADS, to remove one from the pool, or to switch to a new one.
WPM1
Is used with the /COMPT and /RCOMPT commands to notify IMS that the word-processing component is either operable or inoperable.
WPM2
Is used with the /COMPT and /RCOMPT commands to notify IMS that the word-processing component is either operable or inoperable.
WPM3
Is used with the /COMPT and /RCOMPT commands to notify IMS that the word-processing component is either operable or inoperable.
XRCTRACK
Is used in the /START and /STOP commands. This keyword results in calls to the log router to initiate or terminate XRC tracking. It is only valid on a tracking IMS system.
XTRC
Is used with /DISPLAY TRACE to show the XTRC status in order to determine which external trace data set is active, whether the OLDS is used for trace logging, whether XTRC is usable, and the status of the XTRC data sets.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004