MVT/VSE Release 9.5

System Control Statements Summary


System and Job Control

Summary of Control Statements

Statement/Command Area Use
* (Comment) JCS Indicates a comment
/. (Label) JCC, JCS Label statement
/+ (End of Procedure) JCS Indicates the end of a procedure
/& (End of Job) JCS Indicates the end of a job
/* (End of Data) JCS Indicates the end of a data file
ALLOC   Not used under MVT/VSE
ALTER AR Alter the contents of storage
Assgn JCC, JCS Assign a logical I/O unit to a physical device
BANDID   Not used under MVT/VSE
BATCH   Not used under MVT/VSE
CACHE   Not used under MVT/VSE
CANcel AR, JCC Cancel a job (JCC) or region (AR) with or without a dump.
CLOse JCC, JCS Closes a system/programmer logical device assigned to a tape, DASD, or diskette
Date JCC, JCS Set the date in the communications area
DEFine JCC Define Private Core Image Libraries for a region or the system
DISplay AR, JCC Display region(s) status
DLBL JCC, JCS Define DASD/Diskette label information
DSPly AR Display virtual storage
Dump AR Dump all or part of virtual storage
DVCDN JCC, JCS Make a device unavailable for system use
DVCUP JCC, JCS Make a device available for system use
Equate JCC, JCS Modify the assignments made by ASSGN
EXEc JCC, JCS Execute a program or procedure
EXTent JCC, JCS Define a DASD/diskette extent for a file
FREE   Not used under MVT/VSE
GOTO JCC, JCS Branch to a specific label
HOLD   Not used under MVT/VSE
ID   Not used under MVT/VSE
IF JCC, JCS Check a local condition
Job JCS Indicates the beginning of control information for a job
JOBCom   Not used under MVT/VSE
LBLTYP JCS Define storage for tape/nonsequential DASD file processing
LFCB AR Load a buffer image into the FCB for a printer
LIBDEf JCC, JCS Define library chains
LIBDrop JCC, JCS Drops library chain definitions
LIBList JCC, JCS Display library chain definitions
LIBR   Not used under MVT/VSE
LIStio JCC, JCS Display/list current I/O assignments
LOG AR, JCC Log to SYSLOG all Job Control Commands/Statements
LUCB AR Load buffer image into UCS of a printer
Map AR, JCC Produce a map of storage use
Mode AR Alter/set device recording mode
MPXGTN   Not used under MVT/VSE
MSECS   Not used under MVT/VSE
Msg AR Transfer region control to operator communications routine (STXIT)
MTC JCC, JCS Magnetic tape control services
Mvcom JCC Place information into the user communications area
NEWVOL AR Notify a region of waiting volume action
NOLOG JCC, AR Suppress logging to SYSLOG of certain commands/statements
NOPAUSE   Not used under MVT/VSE
NPGR   Not used under MVT/VSE
OFFLINE   Not used under MVT/VSE
ON JCC, JCS Test for condition
ONLINE AR Simulate a device End/Ready status
Option JCC, JCS Specify processing and output options
OVEND   Not used under MVT/VSE
Pause AR, JCC, JCS Cause a pause in processing
PROC JCC, JCS Define/initialize symbolic parameters within a procedure
PRTY AR, JCC Display, alter, or set system priorities
PRTYIO   Not used under MVT/VSE
PWR   Not used under MVT/VSE
RC   Not used under MVT/VSE
REPLID   Not used under MVT/VSE
RESERV   Not used under MVT/VSE
RESET JCC, JCS Reset temporary I/O device assignments
ROD JCC Record all statistical record counters on SYSREC (not TP devices)
RSTRT JCS Restart programs after a checkpoint
SET JCC Set controls for program execution
SETDF AR Set/reset default values for 3800 type printers
SETMOD AR Set the 8890 magnetic tape mode
SETPARM JCC, JCS Set a symbolic parameter
SETPRT JCC, JCS Defines control values for 3800 printers.
Show AR Display current status of storage.
SIZE   Not used under MVT/VSE
SPRI / SPL AR Communicate with the SPRI SPOOLing system
Start AR Activate a region or continue processing for a region
STDOPT JCC, JCS Set/reset the permanent job control options established at system initialization
STOP AR, JCC Indicate that a region is not to execute any more jobs
TLBL JCS Define tape label information for processing
TPBAL AR Alter the TP balancing function
UCS JCC Load the Universal Character Set to the specified printer
UNBATCH   Not used under MVT/VSE
UNLOCK AR Release all locked resources for a specified system
UPSI JCC Define UPSI program switches
Vary   Not used under MVT/VSE
VOLume AR Display a summary of mounted DASD devices
VTAM AR Communicate with VTAM
ZONE JCS Define difference between local and Greenwich mean time

* (Comment)

TYPE: JCS

The * (comment) statement is used to include a comment in your job control stream and is generally used for documentation of the job stream.

When the * statement is encountered, the statement, along with any comments on the statement, are displayed on SYSLOG.

The format of the * statement is:

* [comments...]

/. (Label)

TYPE: JCC, JCS

The /. statement is used to allow the placement of a label within a job stream. This label is used as a pointer for skipping via the GOTO statement or the GOTO operand of the ON statement.

Although the /. statement contains the label to where the branch is to be made, processing actually continues with the statement immediately following the /. statement.

The format of the /. statement is:

/. label

/+ (End of Procedure)

TYPE: JCS

The /+ (end-of-procedure) statement is used to indicate the end of a procedure. The /+ statement may be overridden with the "EOP" operand of the CATALP statement of the MAINT utility. This statement is only valid when procedures are being cataloged.

You may also use the /+ statement to terminate a procedure that is currently running in a region.

The format of the /+ statement is:

/+ [comments...]

/& (End of Job)

TYPE: Job Control Statement

The /& (end-of-job) statement is used to indicate the end of job processing. This statement must be the last statement in the job stream.

The format of the /& statement is:

/&

/* (End of Data)

TYPE: JCS

The /* (end-of-data file) statement is used to indicate the end of data input on SYSRDR and SYSIPT. This statement is also recognized for files where LIOCS is reading from a card reader that is not assigned to SYSRDR or SYSIPT.

The format of the /* statement is:

/*comments...]

ALLOC

TYPE: AR, JCC

This Job Control and AR command is not available under the MVT/VSE operating system. Virtual storage allocation is controlled by the operating system. Region sizes may be specified with:

ALTER

TYPE: AR

The ALTER command is used to alter the contents of 1 to 16 bytes of:

  1. Virtual storage, starting at the specified hexadecimal address, or
  2. Virtual storage, starting at the specified hexadecimal address for a specific address space.
The format of the ALTER command is:

ALTer [asid,]address
asid Optional, alter this address space
address Alter this specific address

ASSGN

TYPE: JCS, JCC

The ASSGN statement or command is used to assign programmer logical I/O units to specific devices and/or functions.

If used as a Job Control Statement (prefixed with a "//") the assignment is temporary. That is, it will be cleared when the job processing has completed. If used without the slashes (Job Control Command), the assignment is permanent and must be specifically reset with another ASSGN statement or a DEFINE command.

Note: Devices indicated with the "cuu" operand, may be automatically altered with the use of the EQUATE Job Control Statement/Command.

The format of the ASSGN statement is:

[//] ASsgn SYSxxx,assignment[,op1[,op2[,...[,opn]]]
SYSxxx The programmer logical unit assignment
assignment
   (addr-list)
   cuu
   dev-class
   dlabel
   IGN
   SYSyyy
   UA
   X'cuu

Device search list
Assign to this actual address
Assign to this device class
DASD label
Ignore I/O to this unit
Assign to this logical unit
Unassign the device
Assign to this actual address
Options:
   ALT
   DSN=dsn
   Hn
   PERM
   SHR
   ss
   TEMP
   ucode
      I
      O
      S
   VOL=label

Tape alternate drive when 1st complete
Tape HDR1 DSN (SL tapes only)
Reader input hopper
Permanent assignment
DASD may be shared
Tape mode settings
Temporary assignment
Tape use code
Tape is input
Tape is output
Tape is scratch

DASD/SL tape label for checking

CANCEL

TYPE: AR, JCC

The CANCEL command is used to:

  1. Cancel a region (AR) with or without a dump, or
  2. Cancel an I/O request for a device (AR) which has an outstanding Intervention Required, or
  3. Cancel a job (JCC)
The format of the CANCEL command is:

CANcel cuu
CANcel RxSn
CANcel Rx[,op]
cuu Cancel all I/O for this unit
Rx Cancel this region
Sn Cancel this subtask
Options:
   DUMP
   FORCE
   NODUMP
   NOSYSDMP
   PARTDUMP
   SYSDMP

Dump Region, registers, Supervisor, and used GETVIS areas, and the SVA phase in error
Cancel immediately
Default, no dump is taken
Dump to SYSLST
Dump Region, supervisor, Supervisor control blocks, and any SVA phase in error
Dump to SYSDMP device

CLOSE

TYPE: JCC, JCS

The CLOSE Job Control Command is used to close either:

  1. A system or programmer logical unit assigned to a tape device, or
  2. A system logical unit assigned to a DASD or a diskette.
The CLOSE Job Control Statement is used to close either a system or programmer logical unit assigned to a tape device and applies to temporary assignments only.

The format of the CLOSE command/statement is:

[//] CLOse SYSxxx[,op1[,op2]]
SYSxxx Close this logical device
Options
   ALT
   cuu
   dev-class
   IGN
   ss
   SYSyyy
   UA

Close and assign alternate unit
Close this device
Close and assign to device class
Close and ignore
Close and reset tape mode
Close and assign to this SYS assignment
Close and unassign

DATE

TYPE: JCS

The DATE statement is used to place a date into the communications region.

Note: The actual format of the date is determined by the setting defined when the system is generated. Contact your system programmer for the correct format.

The format of the DATE statement is:

// DAte {mm/dd/yy | dd/mm/yy}

DEFINE

TYPE: JCC, JCS

The DEFINE statement is used to:

  1. Permanently define information for a region (DEFINE). This definition will remain in effect until specifically reset with another DEFINE statement.
  2. Temporarily define information for the current job (//DEFINE). All temporary definitions are reset at the end of the job.
Note: It is not recommended that you mix the LIBDEF and DEFINE statements. Use one or the other. Using a combination of these statements may produce unexpected results.

The format of the DEFINE statement is:

[//] DEFine op1[,op2[,op3..[,opn]]]
DEACT={YES | NO} Load leveling deactivation option.
GETVIS=nnnK Default GETVIS during program execution
HOLD={YES | NO} Region memory save option
LOAD={ANY | HIGH | LOW} Default location for program loads
MAXREAL=nnnK Maximum real memory allowed
MODE={IFREAL | REAL | VIRTUAL} Program execution mode defaults
REGION={ nnnK | AUTH{+nnnK | (nnnK,mmmK)} Default region sizes

DISPLAY

TYPE: AR, JCC

The DISPLAY command is used to display the status of a single region or all regions.

The format of the DISPLAY command is:

DISplay [Rx]

DLBL

TYPE: JCS

The DLBL statement is used to specify file information for DASD and/or diskette label checking.

The format of the DLBL statement is:

// DLBL filename,[op1[,op2[,...[opn]]]]
filename Required symbolic file name
BLKSIZE= Optional, different blocksize than DTFSD
BUFND= Optional, number of VSAM data buffers (VSAM 1.4)
BUFNI= Optional, number of VSAM index buffers (VSAM 1.4)
BUFSP= Optional, VSAM buffer space
CAT=filename Optional, VSAM owning catalog name
CISIZE= Optional CI size for SAM on FBA
date Optional, Retention/Expiration date
DISP={NEW | OLD | KEEP | DELETE | DATE} Optional VSAM disposition combination
DSF Optional, Data secured file
fileid Optional, data set name
{DA | DU | ISC | ISE | SD | VSAM} Optional, File type code
RECORDS={n | (n,n1)} Optional VSAM/SAM record numbers
RECSIZE=nnnn Optional, VSAM/SAM record size

DSPLY

TYPE: AR

The DSPLY command allows the operator to display 16 bytes of virtual storage starting with the hexadecimal address specified. The display may be

  1. For a specific hexadecimal address, or
  2. A hexadecimal address within a given address space.
The format of the DSPLY command is:

DSPly [asid,]address

DUMP

TYPE: AR

The DUMP command allows the operator to dump all or part of virtual storage on a printer or a tape device.

The format of the DUMP command is:

DUmp [asid,]addr-addr[,op2]
asid Dump this address space
addr-addr Required, dump the indicated virtual storage area
BUFFER Optional, dump the SDAID buffer (Tape only)
Rn Optional, dump this region plus additional information
SUP Optional, dump supervisor area and registers
SVA Optional, dump SVA and additional information
cuu Optional, dump output device address

DVCDN

TYPE: JCC

The DVCDN command is used to make a device unavailable for system use. This is generally done when the device is to be removed from the system for some reason.

Note: This command will not be accepted for a device that is being used for SYSRES, SYSREC, SYSCAT, or system page datasets.

If a permanent or temporary assignment exists for the specified device, all logical units associated with the device are unassigned.

Since this command does not close any files associated with the device, prior to issuing the command, you should insure that all logical units are cleared for the device using the CLOSE command.

Refer to the DVCUP command for information on placing a device back into service.

The format of the DVCDN command is:

DVCDN cuu

DVCUP

TYPE: JCC

The DVCUP command is used to place a device into system service which was not previously in service.

Refer to the DVCDN command on page for information on placing a device out of service.

The format of the DVCUP command is:

DVCUP cuu

EQUATE

TYPE: JCC, JCS

The EQUATE Job Statement/Command is used to modify the operands of ASSGN statements and MTC commands before they are resolved by Job Control.

// EQUATE indicates a temporary assignment. This EQUATE will remain in effect until job processing is complete. EQUATE (without the slashes) indicates a permanent EQUATE assignment. This type of EQUATE will remain in effect until specifically reset with another EQUATE statement.

The format of the EQUATE statement is:

[//] EQUate [Rx,][xxx=yyy[,zzz=aaa,..][,NULL[,SHOW]]

EXEC

TYPE: JCC, JCS

The EXEC Statement/Command is used to execute a program or procedure within a job. In general, each EXEC statement is considered a step within a job.

For sites using more than one address space: Execution of a program or procedure within a region that is not assigned to a specific address space, or already running in a specific address space causes Job Control to initiate that region in the first available address space.

The blank execute is used for a "Link-And-Go" operation. OPTION LINK must be specified for a single phase program which has no PHASE statement. The program is actually catalogued under the name Rx$yLAG where 'Rx' is the region ID and 'y' is the CPU-id.

The format of the EXEC command/statement is:

[//] EXEc [[PGM=]progname][,op1[,op2...[opn]]]
[//] EXEc PROC=procname[,parmname[=[value]]],[....]
progname Required positional program name
COMrg40=
   nnnK
   Auto
   Auto+nK
   HIprog
Value to set in COMRG+40
High phase with same first 4 characters.
Defaults to AUTO+8K.
Auto plus the value specified.
Computes the value the same as IBM, but causes considerable overhead.
DEACT=[YES | NO] Load leveling
Getvis=nnnK Amount of GETVIS area to be made available to the program during execution
GO Link and execute option following compile
Load=[Any | High | Low |nK] Specific memory location request
Mode=[Ifreal | Real | Virtual] Program execution mode
PArm= Parameters to pass to the program
PGM= Optional execute program indication
PROC=procname Execute a procedure from the PL or PROC library search chain.
PRTY=[No | Yes] Execution priority request
REAL Run the program using real memory only.
Region=
   nnnK
   AUTO
   AUTO+nnnK
   (nnnK,mmmK)
Region size request.
Region size in number of K
Region will be size of program (DEFAULT)
Size of program
Allocate a minimum and maximum
TIme= Maximum execution time in minutes and seconds

EXTENT

TYPE: JCS

The EXTENT statement is used to define DASD extent (or area) information.

Note that all of the EXTENT statement operands are positional and optional. However, at least one (1) operand must be coded. Operands which are omitted must be indicated by adjoining commas.

The format of the EXTENT statement is:

// EXTent [SYSxxx],[dlabel],[type],[seq-num],[loc],[size],[split]
SYSxxx Optional logical unit
dlabel Optional DASD label
type Optional extent type
seq-num Optional multi-extent sequence
loc Optional beginning relative track/block
size Optional number of tracks/blocks for allocation
split Optional CKD SAM file track split

GOTO

TYPE: JCS, JCC

The GOTO Job Control Statement/Command is used to cause all JCL statements to be skipped up to the specified LABEL statement. The GOTO statement/command is only valid within a job.

The format of the GOTO command/statement is:

[//] GOTO [label | $EOJ]

IF

TYPE: JCS, JCC

The IF statement/command is used to check a condition and indicate that the following statement is to be executed if the condition is true.

If the result of the IF test is FALSE, the statement following the IF statement is bypassed.

The IF statement may only be used within a job.

The format of the IF Statement/Command is:

[//] IF condition [operator condition] THEN
condition Condition for testing
operator Logical operator
THEN If TRUE, execute following statement

JOB

TYPE: JCS

The JOB statement is used to indicate the beginning of a job that is to be processed. This should always be the first Job Control Statement in a job stream. It may however, be preceded by Job Control Commands (i.e., DATE, etc.)

The format of the JOB statement is:

// Job jobname[,acinfo[,op1[,op2[,...[opn]]]]]
jobname Required job name
acinfo Optional job accounting information
CLass= Optional reader class for SPRI
INroute= Optional reader input Routing Code
PRty= Optional reader queue priority for SPRI
Region= Optional default region size for the job.
RELease= Optional time of day to release job
ROute= Optional default output routing for reports.
TIme= Optional maximum job processing time
TYprun=[Hold | Copy] Optional processing options

LBLTYP

TYPE: JCS

The LBLTYP Job Control Statement is used to define the amount of storage that is to be reserved for processing of tape and nonsequential disk file labels. This statement is not normally required as MVT/VSE provides label information space from the region GETVIS areas.

Storage is reserved at link-edit or execution (for self-relocating programs) time in the label save area of the executing region.

The format of the LBLTYP statement is:

// LBLTYP [TAPE | NSD(nnn)]

LFCB

TYPE: AR

Refer to the SPRI "FCB" command for additional information on loading of the Forms Control Buffer.

The LFCB AR Command causes the system to load the specified phasename into the Forms Control Buffer (FCB)of the indicated printer.

FCBs are only valid for those printers that use form skip operations for paper control.

The format of the LFCB Command is:

LFCB cuu,phase[,FORMS=xxxx[,LPI=n[,NULMSG]]]

LIBDEF

TYPE: JCC, JCS

Use the LIBDEF Statement/Command to define a chain of libraries that is to be used for an operation. A chain of libraries is said to be concatenated. The functions are identical for a command or statement.

Continuation lines are allowed for this command/statement.

The format of the LIBDEF Command/Statement for MVT/VSE systems that do not support LIBR is:

[//] LIBDEf [CL | RL | SL],use=(lib[,lib[,...]])[,chain]
use
   FROM=
   NEW=
   SEARCH=
   TO=
Library use
Input library
New library for CORGZ NEWVOL
Search these libraries
Output library
chain
   PERM
   TEMP
Chaining specification
Chain to be permanent
Default, chain to be temporary

LIBDROP

TYPE: JCS, JCC

The LIBDROP command/statement is used to reset the library chain established with one or more previous LIBDEF commands/statements.

MVT Non-LIBR Systems

The format of the LIBDROP statement/command for MVT/VSE systesms that do not support LIBR is:

[//] LIBDRop [{CL | RL | SL}[,chaintype[,{PERM | TEMP}]]]
chaintype
   ALL
   FROM
   NEW
   SEARCH
   TO
Chain(s) to be dropped
Drop all libraries of the specified type
Drop library from the FROM= chain
Drop library from the NEW= chain
Drop library from the SEARCH= chain
Drop library from the TO= chain

MVT LIBR Systems

The format of the LIBDROP statement/command for MVT/VSE systesms that support LIBR is:

[//] LIBDROP membertype[,SEARCH[,CATALOG[,{PERM | TEMP}]]]
membertype
   *
   OBJ
   PHASE
   PROC
   SOURCE
Member type to drop
Drop all member types
Drop object modules
Drop phases
Drop procedures
Drop source members

LIBLIST

TYPE: JCS, JCC

The LIBLIST statement/command is used to display the current permanent and/or temporary library definitions established with a LIBDEF statement. Continuation lines are supported for this statement.

MVT Non-LIBR Systems

The format of the LIBLIST statement/command for MVT/VSE systems that do not support LIBR is:

[//] LIBList [{CL | RL | SL}[,{* | ALL | Rx}[,{SYSLST | SYSLOG}]]]

MVT LIBR Systems

The format of the librarian LIBLIST statement/command for MVT/VSE LIBR is:

[//] LIBList membertype[,{Rx | *}[,{SYSLST | SYSLOG}]]

LIStio

TYPE: JCS, JCC

The LISTIO Statement/command is used to display a list of the current I/O assignments. The display is directed to SYSLOG for a Job control command (no slashes) or to SYSLST for a Job control statement.

The format of the LISTIO statement/command is:

[//] LIStio type
type
   ALL
   ASSGN
   cuu
   DOWN
   PROG
   Rx
   SYS
   SYSxxx
   UA
   UNITS
   XPCC
Type of I/O to be listed
List all region assignments
List system/programmer assigned units
List units assigned to this device
List units in down status
List programmer assigned units
List units assigned in this region
List system units
List units assigned to this logical unit
List units that are unassigned
List logical units assigned to physical
List XPCC/APPCVM operands units

LOG

TYPE: AR, JCC

The LOG command is used to:

The format of the LOG command is:

LOG

LUCB

TYPE:AR

Refer to the SPRI UCS command for information on loading of the Universal Character Set buffer.

Use the LUCB command to load the specified buffer image phase to the indicated printer Universal Character Set buffer. This command is only valid for those printers supporting the UCS feature.

The format of the LUCB command is:

LUCB cuu,phase[,FOLD[,NOCHK[,TRAIN=xxx[,NULMSG]]]]
cuu Required printer to load the UCB
phase Required UCB phase name
TRAIN=xxx Optional 1403 train identification

MAP

TYPE: AR, JCC

The MAP command is used to produce a display of:

The display produced is of virtual storage. As such, the actual amount of storage indicated may not reflect your real storage. This is particularly noticeable with the amount is greater than 100%. This is because GETVIS space is included in the SVA area.

The format of the MAP command is:

MAp [V | R]

MODE

TYPE: AR

The MODE command is used to control options for Recoverable Machine Check Interrupts (MCI). Using the MODE command you can:

  1. Reset recording for unlabeled and nonstandard labeled tapes.
  2. Set intensive, diagnostic, or no recording mode for devices other than teleprocessing devices.
  3. Display the system operating modes.
  4. Specify an EFL value to override that in effect.
  5. For System 370/145/148: Place control storage ECC in threshold mode.
The format of the MODE command is:

MOde CR
MOde IR
MOde R
MOde STATUS
MOde CE,cuu[,[I | D][,xx,y]]
MOde CE,cuu[,N]
MOde ECC[,[M | C][,[R | Q | TH][,E=eeee[,T=tttt]]]]
MOde HIR[,[M | C][,[R | Q | TH][,E=eeee[,T=tttt]]]]
cuu Device address
(xx,y) Byte (xx) and bit (y) of sense data to be checked.
eeee Error count threshold.
tttt Time threshold.

MSG

TYPE: AR

The MSG command is used to allow operator communication with a region that has communications available via the use of the STXIT macro.

This command is generally used to communicate specific instructions to a region running a program that requires external communications for some types of operations. This is generally regions running CICS, VTAM, etc.

The format of the MSG command is:

Msg Rx

MTC

TYPE: JCS, JCC

The MTC Command/Statement is used to control magnetic tape operations.

The format of the MTC Command/Statement is:

[//] MTC operation,unit[,nn]
operation
   BSF
   BSR
   DSE
   ERG
   FSF
   FSR
   RUN
   REW
   WTM
MTC operation to be performed
Back Space File
Back Space Record
Data Security Erase
Erase tape Gaps
Forward Space File
Forward Space Record
Rewind and Unload
Rewind
Write Tape Mark
unit
   SYSxxx
   cuu
unit to be used for operation
Logical unit
Physical device address
nn Number of times to perform the operation

MVCOM

TYPE: JCC

The MVCOM Job Control Command is used to place up to eleven (11) bytes of information in the user area of the communications region. The information specified will replace the contents of this area from displacement +12 through +22. Only the actual number of bytes specified is placed in this area. Any remaining locations are left unaltered.

The format of the MVCOM command is:

MVCOM VALUE=string
string
   'string'
   X'hexstring'
value to be placed into the area
1 to 11 characters
2 to 22 hexadecimal representations

NEWVOL

TYPE: AR

The NEWVOL command is used to indicate to a region that:

The format of the NEWVOL command is:

NEWVOL Rx[,IGNORE]

NOLOG

TYPE: AR, JCS, JCC

The NOLOG command is used:

The format of the NOLOG command is:

NOLOG

ON

TYPE JCC, JCS

The ON statement/command sets a global conditional test for the duration of a job. Each time a job step completes, following an ON statement, the condition is tested. Default ON conditions are set at the beginning of each job. See Key Points for the default conditions.

When the ON condition(s) are tested and result in a TRUE condition, the specified action is taken. If a FALSE condition results from the ON statement, the next statement in the job stream is executed.

The ON statement may only be used within a job.

The format of the ON Statement/Command is:

[//] ON condition [operator condition]action
condition Test to be performed
operator Logical operator connecting 2 conditions
action Action if TRUE

ONLINE

TYPE: AR, JCC

The ONLINE Attention Routine command is used to simulate a device End/Ready status for the specified device.

The format of the ONLINE command is:

ONLINE cuu

OPTION

TYPE: JCS, JCC

The OPTION statement is used to indicate different options that should be used for processing.

When used as a Job Control Command (OPTION), the options specified are to be permanent for that region. All Options may be made permanent except:

When used as a Job Control Statement (//~OPTION), the options are reset at End-of-Job.

The format of the OPTION statement is:

[//] OPtion operand
ACANCEL Set automatic job cancel
NOACANCEL Reset automatic job cancel (default)
CATAL Catalog phase or program, sets LINK option
DELEQID Automatic deletion of "EQUAL FILE ID"
NODELEQID No automatic deletion of "EQUAL FILE ID"
dumptype
   DUMP
   FDUMP
   NODUMP
   SDUMP
Control dump options
Dump region
Force region dump
No dump
Region/supervisor dump
FASTTR CCW fast translation
JARPT= JOB NO STEP Job accounting SYSLST reporting
Summary at end of job
No stats on SYSLST
EOJ report and resource use
JCANCEL Set automatic skip to End-of-Job
NOJCANCEL Reset automatic skip to End-of-Job (default)
LINK Object module is to be link-edited
LOGSRC Log JCL prior to substitution
NOLOGSRC Suppress the LOGSRC option (default)
runtype
   RERUN
   NORERUN
Type of processing being done
Rerun processing
Normal run processing/reset RERUN option
NOFASTTR No CCW fast translation
NOSKIP No skip for each program on SYSLST
PARSTD=
   ADD
   DELETE
   Rx
Partition standard label options
Add without any delete
Delete matching DLBL
Clear region labels and add
SKIP Skip for each program on SYSLST
STDLABEL=
   ADD
   DELETE
System label options
Add without any delete
Delete
USRLABEL=
   ADD
   DELETE
User label options
Add to user label without delete
Delete DLBLs

PAUSE

TYPE: AR, JCS, JCC

The PAUSE Command/Statement is used to:

The format of the PAUSE command/statement is:

[//] PAuse [comments]
PAUSE [Rx[,EOJ]]

PROC

TYPE: JCS, JCC

The PROC statement may only be used within a cataloged procedure and, if used, must be the first statement in the procedure.

The PROC Command/Statement is used to assign initial values to symbolic parameters within a cataloged procedure.

If the PROC statement is not used to assign initial values to symbolic parameters, the symbolics are initialized without a default and must be specifically defined using an EXEC PROC or SETPARM statement.

You may not use symbolic parameters as a value.

The format of the PROC command/statement is:

[//] PROC parm=[value]...
parm= The name of the symbolic being set
value The value being assigned to the symbolic

PRTY

TYPE: AR, JCS

The PRTY command is used to allow the operator to:

  1. Display the priorities currently assigned to each region, and
  2. Assign a priority to a region or regions.
Use of the PRTY command without any operands will cause a display of the current region priorities. Regions are displayed in increasing priority from left to right. That is, a region will have a higher priority than any shown to its left.

Note that this command has the effect of creating priority groups. A group will have a higher priority than any single region or region group to its left.

The format of the PRTY command is:

PRTY
PRTY Rx[,Rx[,...[Rx]]]
PRTY Rx=Rx[,Rx=Rx[,Rx=Rx[,...[Rx=Rx]]]
Rx A region identifier
Rx=Rx Regions are to have the same priority

RESET

TYPE: JCS, JCC

The RESET Statement/Command is used to reset all temporary sublibrary definitions and I/O assignments to the permanent default values.

The format of the RESET statement/command is:

[//] RESET {SYS | PROG | ALL | SYSxxx | XPCC}

ROD

TYPE: JCC

The ROD command is used to record all statistical data record counters (with the exception of TP devices) to the Recorder file on SYSREC.

This command must not be issued until all jobs are complete and no processing is being done.

The format of the ROD command is:

ROD

RSTRT

TYPE: JCS

The RSTRT statement is used to restart a job that has been properly checkpointed using the CHKPT macro instruction in a program.

Restarting is accomplished by entering a RSTRT statement followed by the Job control that was used for the original processing.

The format of the RSTRT statement is:

// RSTRT SYSxxx,nnnn[,filename]
SYSxxx Required logical unit of checkpoint file

nnnn

Required checkpoint record number
filename Optional DTFPH/CHKPT file name

SET

TYPE: JCC

The SET command is used to define controls for job execution. The actual setting of the options must be defined prior to starting the job.

The format of the SET command is:

SET op[=op]
HC={CREATE | NO | YES} Hardcopy file option
LINECT=nn SYSLST line count for print
RCLST=nnnnn SYSLST minimum record warning
RCPCH=nnnnn SYSPCH minimum record warning
RF={CREATE | NO | YES} Recorder file option

DATE={mm/dd/yy | dd/mm/yy}

Set permanent system date
SDL Add phases to SDL and SVA
UPSI=xxxxxxxx Set UPSI bits

SETDF

TYPE: AR

The SETDF command is used for 3800 type printers and allows the operator to:

The format of the SETDF command is:

SETDF device[,op1=op1[,op2=op2[,...[opn=opn]]]]
device
   3800
   cuu
Devices to be affected
All 3800 type devices
Only this device
BURST={N | Y} Burst or continuous output form
CHARS=name Character arrangement table
FCB=name Forms Control Buffer
FLASH=name Overlay flashing
FORMS=name Default STANDARD form
LIST Display default settings
MODIFY=name Copy modification
RESET Set all to defaults

SETMOD

TYPE: AR

The SETMOD command is used to define mode settings for 8809 Magnetic Tape units only. This command is used to define if "Streaming" or "Start-Stop" mode is to be used.

The format of the SETMOD command is:

SETMOD cuu[,mode]

SETPARM

TYPE: JCS, JCC

The SETPARM statement is used to define a symbolic parameter and assign a value to it. The value can then be used as a substitution value in subsequent statements and tested by IF statements. If the value contains special characters or blanks it must be inclosed in quotes.

For example, the value of parameter TPUNIT is set to 4B0 by a SETPARM TPUNIT=4B0 statement. When job control processes an ASSGN SYS010,&TPUNIT statement it will result in ASSGN SYS010,4B0.

Continuation lines are supported for this statement.

You may only use the SETPARM statement within a job.

The format of the SETPARM statement/command is:

[//] SETPARM sparm=value[,sparm=value[...]]

sparm A symbolic parameter
value Value to be assigned

SETPRT

TYPE: JCS, JCC

The SETPRT Job Control Statement or Command allows the user to define control values for the IBM 3800 (or compatible) printer. A minimum of one (1) operand must be specified.

The values specified with the SETPRT statement/command are only valid for current job processing. Values are reset at the end of the job to the defaults are specified for your installation.

The format of the SETPRT statement/command is:

[//] SETPRT SYSxxx,op1=op[,op2=op[...opn=op]]
SYSxxx Required, logical unit identifier
BURST={Y | N | *} Burster/trimmer use
CHARS=({tblname... | *}) Character arrangement table
COPIES=nn Number of copies of each page to print
DCHK={B | U} Data check handling
DEBUG={NORM | TERM | DUMP | TRAC} Debug exit handling
DFLT={N | Y} Default specifications
FCB=[(]fcbname[,V][)] FCB to be used
FLASH=[(]oname[,nn][)] Overlay use
FORMS=form Form identifier
INIT={N | Y} Hardware default reset
MODIFY=(...)
   *
   cname
   tname
Copy modification
Default copy modification
Copy modification phase suffix
Character arrangement table
SEP=O Data set separation
TRC={N | Y} DTF 1st character indicator

SHOW

TYPE: AR

The SHOW command is used to display the current status of storage use by the MVT/VSE system.

The format of the SHOW command is:

Show

SPRI / SPL

TYPE: AR, JCC

The SPRI (or SPL) command is used to pass a command to the SPRI SPOOLing system.

Refer to current SPRI documentation for a complete list of all commands that may be used.

The format of the SPRI (or SPL) command is:

SPRI command op1[,op2[,...[opn]]

START

TYPE: AR

Use the START command to start a region that will be used for processing a job. If:

  1. A region is not specified, the first available region will be started,
  2. A specific region is specified, that region will be started.
The format of the START command is:

Start [Rx]

STDOPT

TYPE: JCC, JCS

The STDOPT Statement/Command is used to:

The STDOPT Job Control Command (no slashes) is used to define permanent options. These options will remain in effect until specifically reset with another STDOPT Job Control Command or the system is IPL'd.

The STDOPT Job Control Statement (// STDOPT) is used to specify temporary options. These options are reset to the default when a job has completed.

You may use the OPTION command to override certain options set with the STDOPT statement/command.

The format of the STDOPT statement/command is:

[//] STDOPT op1[,op2[,...[,opn]]]
ACANCEL={NO | YES} Automatic Job Control cancel for ASSGN and LIBDEF
ALIGN={YES | NO} Assembler data alignment
CHARSET={48C | 60C} PL/I input translation
DATE={MDY | DMY} Date format
DECK={YES | NO} Object module output
DUMP={YES | NO | PART} DUMP options
EDECK={YES | NO} Assembler edited macros on SYSPCH
ERRS={YES | NO} Summarize compile/assemble errors on SYSLST
FASTTR=NO Turn off fast CCW translation
HCTRAN={YES | NO} Hardcopy uppercase
JCANCEL={YES | NO} Automatic Job Control error cancel
LINES=nn SYSLST lines per page
LIST={YES | NO} Write compile/assemble source/diagnostics to SYSLST
LISTX={YES | NO} Object module listing on SYSLST
LOG={YES | NO} JCS output on SYSLST
RLD={YES | NO} Print relocation directory information

SXREF={YES | NO}

Print assembler short cross-reference on SYSLST
SYM={YES | NO} Print symbolic listing on SYSLST
SYSDMP={YES | NO} Dump output to SYSDMP or SYSLST
TERM={YES | NO} Compiler messages on SYSLOG
XREF={YES | NO} Compiler/assembler cross reference list

STOP

TYPE: JCC

The STOP command is used to indicate that a region is no longer to be used for processing of jobs. This command removes the region from automatic selection when a job is to be run.

The format of the STOP command is:

STOP

TLBL

TYPE: JCS

The TLBL statement is used to specify information that is to be used for label checking and/or writing. This statement is allowed for both EBCDIC and ASCII files.

Note: All operands on the TLBL statement are positional. If one or more is not coded, it must still be indicated with the use of a comma.

The format of the TLBL statement is:

// TLBL filename,[fileid],[date],[tlabel],[vol],[seq],[gen],[ver]
filename Required DTF unique filename
fileid Optional file identification
date Optional retention/create date
tlabel Optional tape label
vol Optional volume sequence number
seq Optional multi-volume sequence number
gen Optional file generation number
ver Optional file version number

TPBAL

TYPE: AR

The TPBAL command is used by the system operator to:

The TPBAL function allows the MVT/VSE system to delay processing in the specified number of partitions. This may be used to improve performance of telecommunication operations.

The format of the TPBAL command is:

TPBAL [n]
n Number of regions to be delayed

UCS

TYPE: AR

Use the UCS command to load the Universal Character Set buffer contained in a phase to be loaded to the indicated printer.

The format of the UCS command is:

UCS SYSxxx,phasename[,FOLD[,BLOCK[,NULMSG]]]
SYSxxx Required logical device assignment
phasename Required phase containing the UCS

UNLOCK

TYPE: AR

Use the UNLOCK command to release all resources locked, via the system Lock File, for a specified system.

The format of the UNLOCK command is:

UNLOCK SYSTEM=sssssssstttt
ssssssss Required CPU serial number
tttt Required CPU type

UPSI

TYPE: JCS

The UPSI (User Program Switch Indicators) statement is used to define program switches that will be tested at program execution time.

The format of the UPSI statement is:

// UPSI upsi-string

VOLUME

TYPE: AR

The VOLUME command is used to display a summary of the mounted DASD volumes. This information includes:

  1. The unit address where the volume is mounted,
  2. If the volume is or is not is use by the system,
  3. The volume serial identification (label).
If the VOLUME command is entered without any operands, a display is presented showing all of the system DASD devices.

Use of the VOLUME command will cause Automatic Volume Recognition for volumes just mounted (or linked under VM) so that they may be used.

If no address options are indicated, all available DASD are displayed.

The format of the VOLUME command is:

VOLume [c[u[u]]]

VTAM

TYPE: AR

The VTAM command is used to communicate commands to VTAM (Virtual Telecommunications Access Method).

The format of the VTAM command is:

VTAM cmd-string

ZONE

TYPE: JCS

The ZONE statement is used to define the difference between local time and Greenwich Mean time.

Most installations preset this time differential with the MVT/VSE generation options or at IPL time. Check with your systems staff prior to using this statement.

The format of the ZONE statement is:

// ZONE {EAST | WEST},hh/mm