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.
- ABDUMP
- Requests abnormal termination and a dump of the following:
- Application program executing in a region specified in the /STOP
REGION command. The parameter stated with ABDUMP must be the name
of a transaction currently scheduled for the specified region.
- IMS control region when used with the /CHECKPOINT FREEZE, PURGE, or DUMPQ command.
- Active control region in an XRF environment when used with either
of the following commands:
- The /SWITCH command in the active system
- The /SWITCH command in the alternate system, when it is on the same processor
as the active system
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:
- /BROADCAST, to refer to any terminal that:
- Is not stopped
- Is not locked (VTAM)
- Is not being polled (BTAM BSC)
- Has not had the /PSTOP command issued and completed against it
- /DISPLAY, to refer to transaction codes, programs, regions, classes,
terminals, the VTAM ACB, and subsystems. It is also used with /DISPLAY CCTL to show the active threads associated with the coordinator
controller.
- /SWITCH, to indicate that the command is being entered on the active
system in an XRF environment.
- 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:
- /RECOVER REMOVE, to specify that the recovery list will be eliminated.
- /RECOVER STOP, to specify that recovery will abort for all database data sets and
areas (all entries) in the recovery list.
- AOITOKEN
- Is used with the following commands:
- /DEQUEUE, to dequeue and discard messages associated with the specified AOI
token name.
- /DISPLAY, to show all the AOI tokens in the system.
- /PSTOP REGION, to post an application program waiting for messages associated
with an AOI token.
- 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:
- /DISPLAY, to show LU 6.2 related activities.
- /PURGE, to purge transaction schedule requests from APPC/MVS.
- /SECURE, to control the RACF security level from LU 6.2 application
programs.
- /START, to start transaction schedule requests from APPC/MVS.
- /STOP, to stop transaction schedule requests from APPC/MVS.
- 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:
- /DBRECOVERY, to allow recovery by DEDB area.
- /DISPLAY, to show the DEDB areas being processed.
- QUERY, to display information about DEDB areas and area data set
information in an IMSplex.
- /START, to make DEDB areas available for processing.
- /STOP, to stop the processing of DEDB areas.
- |UPDATE, to change the status of area resources in an IMSplex.
- 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:
- /CHANGE, to specify that the autologon information previously specified
by a user descriptor, output creation exit routine (DFSINSX0), or
signon exit routine (DFSSGNX0) is being updated dynamically.
- /DISPLAY USER, to display the current autologon information for the specified user.
- BACKUP
- Is used with the following commands:
- /ERESTART, to indicate that the control region is an alternate system
in an XRF environment.
- /STOP, to terminate an alternate system.
- /SWITCH, to indicate the command is being entered on the alternate
system.
- 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:
- /RECOVER ADD, to specify that one or more change accumulation groups as defined
in the RECON data sets will have their database data sets and areas added to
the recovery list.
- /RECOVER REMOVE, to specify that one or more change accumulation groups as defined
in the RECON data sets will have their database data sets and areas removed
from the recovery list.
- /RECOVER STOP, to specify that recovery processing is to be stopped for
the database data sets and areas in the specified change accumulation groups
as defined in the RECON data sets.
- 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:
- /ERESTART, to identify the desired shutdown/restart sequence. Valid parameters
are 0 or the checkpoint number provided by IMS when the system was
shut down.
- /NRESTART, to identify the desired shutdown/restart sequence. The only
valid parameter for /NRESTART is 0.
- /SWITCH OLDS, to take a simple checkpoint after switching OLDS.
- 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:
- /DISPLAY, to identify the status of conversations.
- /EXIT, to terminate an active or held conversation; a
valid parameter when terminating a held conversation is the identification
of the conversation provided by IMS when the /HOLD command was used to suspend the conversation.
- /RELEASE, to resume a previously held conversation; a valid parameter
is the identification of the conversation provided by IMS when the /HOLD command was used to suspend the conversation.
- /SET, to establish the destination of the next message entered
on a terminal that is in a conversation.
- 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:
- /DBDUMP
- /DBRECOVERY
- /DELETE
- /DISPLAY
- /LOCK
- /START
- /STOP
- /UNLOCK
- 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:
- /DBRECOVERY, to allow recovery by data group.
- /START, to make data groups available for processing.
- /STOP, to stop the processing of data groups.
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:
- /RECOVER ADD, to specify that one or more full function database data sets will be
added to a recovery list.
- /RECOVER REMOVE, to specify that one or more full function database data sets will be
removed from the recovery list.
- /RECOVER STOP, to specify that recovery processing is to be stopped for
the specified full function database data sets.
- DBDSGRP
- Is used with the following commands:
- /RECOVER ADD, to specify that one or more DBDS groups as defined in the RECON
data sets will have their database data sets added to the recovery list.
- /RECOVER REMOVE, to specify that one or more DBDS groups as defined in the RECON
data sets will have their database data sets removed from the recovery list.
- /RECOVER STOP, to specify that recovery processing will stop for the database data sets
and areas making up the specified DBDS groups as defined in the RECON
data sets.
- 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:
- /DISPLAY LTERM, for terminal queues.
- /DISPLAY NODE, for terminals connected to the node.
- /DISPLAY USER, for users on terminal queues.
- 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:
- /ASSIGN, to change a logical terminal input assignment without changing
the output assignment.
- /DISPLAY LUNAME, to display information about LU 6.2 application programs.
- /START LUNAME, to make the LUNAME available for inbound and synchronous outbound
activities.
- /STOP LUNAME, to stop the LUNAME for inbound and synchronous outbound activities.
- /TRACE LUNAME, to trace the LUNAME for inbound and synchronous outbound activities.
- 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:
- /PSTOP REGION
- /START REGION
- /STOP REGION
- 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:
- /DISPLAY AREA, to display only those areas that are currently in a long
busy condition or are in long busy recovery mode.
- /START, to specify the MADS I/O timing function. The /START
MADSIOT command is valid only after the long busy handling function
is disabled for a link failure, a structure failure, or a rebuild
failure.
- 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:
- /BROADCAST MASTER
- /DEQUEUE
- /DISPLAY
- /MSASSIGN
- /MSVERIFY
- /PURGE
- /START
- /STOP
- MSPLINK
- Is used with the following commands to refer to a physical
link in a multiple systems configuration:
- /DISPLAY ASSIGNMENT
- /MSASSIGN LINK
- /PSTOP
- /RSTART
- 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:
- All members of the recovery group are not in the same recovery
list.
- All members of the recovery group do not need to be recovered
to the same point in time.
- 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:
- /END NODE
- /EXCLUSIVE NODE
- /TEST MFS NODE
The following commands are valid for static nodes with ISC parallel
sessions:
- /END NODE USER p1 USER p2
- /EXCLUSIVE NODE p1 USER p2
- /TEST MFS NODE p1 USER p2
- 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:
- /DBDUMP
- /DBRECOVERY
- /STOP DATABASE | 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:
- /ASSIGN, to indicate that the assignment changes specified by the /ASSIGN command are lost when control
blocks are deleted by the system when they are no longer needed.
- /CHANGE, to indicate that the changed autologon information should
not be retained.
- 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:
- /RECOVER ADD, to specify that the databases and areas undergoing recovery will
be left offline after recovery is complete.
- /RECOVER START, to specify that the database data sets and areas in the recovery list
will remain offline after recovery is complete.
- 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:
- /DISPLAY LUNAME, to display LU 6.2 application programs.
- /START LUNAME, to make the LU name available for asynchronous outbound activities.
- /STOP LUNAME, to stop the LU name for asynchronous outbound activities.
- /TRACE SET LUNAME, to trace the LU name for asynchronous outbound activities.
- 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:
- /CHANGE, to replace a password known to the password security specifications of
the IMS Security Maintenance utility with a new password.
- /DELETE, to eliminate password security of the IMS Security Maintenance utility
for a currently password-protected resource.
- /MODIFY PREPARE, to add a password security definition.
- /NRESTART, to request that the password security specifications of
the IMS Security Maintenance utility be in effect at completion
of the restart process.
- 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:
- CHECKPOINT, to request termination of IMS.
- /DEQUEUE, to cancel all output messages enqueued on a logical terminal
or destined to a physical terminal.
- /PSTOP, to stop a channel-to-channel partner link that is not idle
after a system failure.
- 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:
- /DISPLAY
- /DISPLAY LINE
- /DISPLAY LINK
- /DISPLAY LTERM
- /DISPLAY LUNAME
- /DISPLAY MSNAME
- /DISPLAY NODE
- /DISPLAY Q
- /DISPLAY TMEMBER
- /DISPLAY TRANSACTION
- /DISPLAY USER
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:
- /DISPLAY RECOVERY, to specify the recovery token associated with the specific recovery
list to display.
- /RECOVER ADD, to specify the unique identifier associated with the recovery
list that the /RECOVER ADD command operates against.
- /RECOVER REMOVE, to specify the unique identifier associated with the recovery list
that the /RECOVER ADD command operates against.
- /RECOVER START, to specify the logical terminal (including IMS master terminal and z/OS system
console) that owns the recovery list that the /RECOVER START command operates against.
- 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.
- Valid REGION parameters used with /ASSIGN, /PSTOP, and /STOP are the decimal numbers from 1 through the number of regions
defined during system definition.
- When used with /PSTOP, REGION returns a QC status code to an application program
active in the specified region.
- Valid REGION parameters used with /START are names of IMS.JOBS members.
- When used with /DISPLAY ACTIVE, REGION shows the status of active regions.
- 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:
- /DISPLAY, to display the status of programs with specified routing
codes.
- /DISPLAY STATUS, to display routing codes that are not active.
- /START, to activate routing codes and allow transactions associated
with the routing codes to process.
- /STOP, to prevent transactions associated with the routing code
from being processed.
- SAVE
- Is used with the following commands:
- /ASSIGN, to prevent deletion of user and LTERM control
blocks across session and IMS restarts.
- /CHANGE, to indicate that the changed autologon information should
be retained.
- /RECOVER STOP, to specify that the recovery list is not to be deleted when recovery
is stopped.
- 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:
- /CQCHKPT
- /CQQUERY
- /CQSET
- /DISPLAY
- QUERY
- 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:
- /DELETE, to eliminate terminal security for a specified transaction.
- /MODIFY PREPARE, to add terminal security.
- /NRESTART, to request that the terminal security specifications of
the IMS Security Maintenance Utility be in effect at completion
of the restart process.
- /SMCOPY, to control the printing of command output to the secondary
master terminal when commands are issued from terminals other than
the master terminal.
- 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:
- The /NRESTART command to request that user identification verification
be in effect at the end of the normal restart.
- Commands that support ISC nodes, in which case the user can
be either:
- A dynamically created ISC user
- An ISC static user, which is an ISC user defined by the SUBPOOL
macro in a system definition.
In this case, the USER keyword refers to a collection of logical
terminals that can be allocated to an ISC node and used with parallel
sessions. It is valid only for ISC nodes defined with a dynamically
allocated set of logical terminals.
When the USER keyword is specified with the NODE keyword, the
USER keyword must follow the NODE specification. When the NODE is
statically defined, the NODE USER combination can be used only with
a command related to an ISC parallel session on that terminal.
- Commands that support dynamic terminals and users, in which
case the user is created dynamically and can be ISC or non-ISC.
If the term "dynamic user" is used in reference to signing
on to a node, the user is a non-ISC user.
In this case, the USER keyword refers to a collection of logical
terminals associated with a user ID that can be signed on to an
ACF/VTAM node. When specified with the NODE keyword, USER must follow
the NODE specification. If the NODE USER descriptor is used to sign
on, the USER keyword parameter must be the node name.
- The /DISPLAY command, in which case the user is signed onto a static terminal
and is a non-ISC static user.
The USER keyword refers to a user ID that is defined to an enhanced
security product such as RACF. A
user ID signed on to a statically defined terminal can be used only
as a parameter with the /DISPLAY USER command.
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.