Use GetJob to insert a copy of the contents of a JES data set group or a POWER job immediately following the current line in the current session.
GetJob may also be entered as GetJ[ob] or GetP.
Optional Operands
JOB is a JES job containing the JES data set group to insert or is the POWER job to insert.
GROUP [JES jobs only]. is the JES data set group to be inserted.
GROUP must not be specified if DSET is specified.
DSET [JES jobs only.]. is the data set to be insert.
DSET must not be specified if GROUP is specified.
BASE specifies the starting line number in the JES data set group or POWER job. If BASE is not specified, insertion starts with the first line.
DEPTH specifies the number of lines to insert. If DEPTH is not specified, insertion continues to the end of the JES data set group or POWER job.
CTL Specify YES or ON to retrieve the carriage control character as the first character of the line. Data characters are shifted one character to the right. If CTL is not specified, carriage control is not retrieved.
For a JES data set group, ASA carriage control (below) is retrieved. (See IBM documentation for additional values.)
Plus (+) = Write without spacing
Space ( ) = Space 1 line before writing
Zero (0) = Space 2 lines before writing
Dash (-) = Space 3 lines before writing
One (1) = Skip to top of page before writing
Normally, for a POWER job, System 370 printer channel commands are retrieved as follows.
Hexadecimal 01 = Write without spacing
Hexadecimal 09 = Space 1 line immediate
Hexadecimal 0B = Write and Space 1 line
Hexadecimal 11 = Write and Space 2 lines
Hexadecimal 19 = Write and Space 3 lines
Hexadecimal 73 = Block Data Check (causes no print action)
Hexadecimal 8B = Skip to top of page immediate
Under certain circumstances, POWER jobs are stored and will be retrieved with ASA carriage control.
JES Notes
If none of JOB, GROUP, and DSET are specified, the last referenced job (and data sets) are inserted. If only JOB is specified, all SYSOUT data sets are inserted.
GetJob sets the last referenced job (and data sets).
POWER Notes
If JOB is not specified, the last referenced job is inserted.
GetJob sets the last referenced job.
When Valid
Check with your System Administrator to determine the restrictions on access to jobs or data sets at your site. The BIXPWQA exit routine distributed with host BIM-EDIT provides several restriction schemes your System Administrator can select from.
Return Codes
OK Successful.
NF Job not found.
-- Codes as defined by BIXPWQA exit routine.
JES Examples
Insert a copy of JES job 4789 $JCL data set lines 200 - 649:
=> getp 4789,dset=$JCL,base=200,depth=450
Insert a copy of JES last referenced job output queue out group 3.1 data sets:
=> getp group=3.1
POWER Examples
Insert a copy of POWER job ASM100 from the list queue:
=> getp asm100
Insert a copy of POWER job COMP, lines 200 - 649, from the punch queue:
=> getp pun.comp,base=200,depth=450