Multisegment DBCTL operator commands

The DBCTL operator commands /CHANGE, /ERESTART, /RMxxxxxx, and /SSR can be entered in multiple segments.

The format of multisegment commands varies according to the environment you are using. For multisegment commands in a DBCTL environment, each segment preceding the last segment requires an end-of-segment (EOS) indicator, which is the CRC followed by the ENTER key. The last (or only) segment requires an end-of-message (EOM) indicator, which is the ENTER key. In addition, each segment must begin with the CRC.

Figure 1 is an example of a multisegment command that has two segments. The CRC is a slash (/), and appears at the beginning and end of the first segment. The EOS of the first segment is the CRC (/) followed by the ENTER key, which does not appear because it is not displayable. The EOM of the second (and last) segment is the ENTER key, so this segment begins with the CRC, but does not end with it.

DBCTL can handle single-segment commands from an unlimited number of consoles concurrently, but the number of consoles that can concurrently issue multisegment commands is limited to eight. A single multisegment command is limited to 241 bytes. If either of these limits is exceeded, a message is sent to the issuing console.

Figure 1. Example of using multisegment commands in a DBCTL environment

 /RMI DBRC='ic dbd(dedbdd01) area(dd01ar0) icdsn(fvt31.dedbdd01.dd01ar0
 .ic.dummy1) icdsn2/
 /(FVT31.DEDBDD01.DD01AR0.IC2.DUMMY1) HSSP'
 DFS000I MESSAGE(S) FROM ID=SYS1 490
 INIT.IC DBD(DEDBDD01) AREA(DD01AR0) -
 ICDSN(FVT31.DEDBDD01.DD01AR0.IC.DUMMY1) -
 ICDSN2(FVT31.DEDBDD01.DD01AR0.IC2.DUMMY1) HSSP
 DSP0203I  COMMAND COMPLETED WITH CONDITION CODE 00
 DSP0220I  COMMAND COMPLETION TIME 89.045   16:24:58.7
 DSP0211I  COMMAND PROCESSING COMPLETE
 DSP0211I  HIGHEST CONDITION CODE = 00
 DSP0058I  RMI COMMAND COMPLETED
 /RMI DBRC='ic dbd(dedbdd01) area(dd01ar0) icdsn(fvt31.dedbdd01.dd01ar0
 .ic.dummy2) /
 /ICDSN2(FVT31.DEDBDD01.DD01AR0.IC2.DUMMY2) HSSP'
 DFS000I MESSAGE(S) FROM ID=SYS1 514
 INIT.IC DBD(DEDBDD01) AREA(DD01AR0) -
 ICDSN(FVT31.DEDBDD01.DD01AR0.IC.DUMMY2) -
 ICDSN2(FVT31.DEDBDD01.DD01AR0.IC2.DUMMY2) HSSP
 DSP0203I  COMMAND COMPLETED WITH CONDITION CODE 00
 DSP0220I  COMMAND COMPLETION TIME 89.045   16:28:10.3
 DSP0211I  COMMAND PROCESSING COMPLETE
 DSP0211I  HIGHEST CONDITION CODE = 00
 DSP0058I  RMI COMMAND COMPLETED

For further guidance on multisegment operator commands, see Operations and automation in IMS product documentation.

You can use null words (for example, FOR, and TO) within the operator commands to help clarify the syntax without affecting the command itself. Because null words are reserved, you must not use them to name system resources. For further guidance on null words, see Operations and automation in IMS product documentation.

You might need to use a password depending on the security facility used. See Security checking with DBCTL for information about security considerations with DBCTL.