SARBCH Control Statements (DELETE - LIST)

Control statements have the following general structure:
view
Control statements have the following general structure:
/
function parameters
  • Code a slash in column 1, followed immediately by the name of the function to be performed.
  • The function name must be followed by one or more blanks and be separated from the parameters.
  • Separate individual parameters by one or more blanks and/or commas.
  • A statement that exceeds 71 characters must be continued on additional statements. When continuing a statement, the statement can be interrupted only between complete parameters or subparameters.
  • Quoted parameters that flow onto additional statements can be continued in column 2 of subsequent statements.
  • Include a comment within the control statements by coding an asterisk in column 1 of the card image containing the comment.
Contents
DELETE
The DELETE control statement deletes the following from the database:
  • An archived SYSOUT
  • The page indexes of a SYSOUT
  • A user ID
  • A logical view
  • A Device
  • A Filter
Syntax:
/DELETE ID=
id
RESOURCE=
xxxxxxxx
SECOND DISK GEN=
nnnnn
SEQ=
nnnnn
USER=
xxxxxxxx
VIEW=
nnn
INDEX FORCE DEV=sname FILT=fname
Where:
  • ID=id
    Specifies the SYSOUT identifier on the SYSOUT or resource group or view that is to be deleted.
    This value can be 1 to 32 characters. If this parameter is specified by itself or with the GEN and/or SEQ parameters, the respective archival SYSOUT group is permanently deleted from the database.
    Note
    : If the id contains embedded blanks, commas, parentheses, equal signs, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".
  • DISK
    Specifies that the disk space occupied by the SYSOUT or resource group is to be deleted from the database.
    If a report is on primary and secondary disk, the first DELETE DISK deletes the primary disk copy and the next DELETE DISK deletes the secondary disk copy.
    If this is a resource group, DISK must be specified.
  • SECOND
    Deletes the space on optical (secondary) disk allocated for a SYSOUT/report.
    If a report is on primary and secondary disk, the DELETE SECOND deletes only the secondary disk copy.
  • GEN=nnnnn
    Specifies the absolute or relative number of the generation of the SYSOUT group to be deleted.
    If omitted, the most recently archived SYSOUT group for the ID is used. This parameter cannot be specified with the VIEW and USER parameters.
  • SEQ=nnnnn
    Specifies the absolute or relative sequence number of the SYSOUT group to be deleted.
    • If omitted, the most recently archived group for the ID and generation specified is deleted. This parameter cannot be specified with the VIEW and USER parameters.
    • If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
    • If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.
    • EX: SEQ=-1
      The second most recently archived SYSOUT is processed regardless of its generation and sequence number.
    • EX: SEQ=-2
      The third most recently archived SYSOUT is processed regardless of its generation and sequence number.
  • USER=xxxxxxxx
    Specifies the name of the USERID to be deleted from the database.
    This parameter cannot be specified with the GEN and SEQ parameters.
  • VIEW=nnn
    Specifies a number from 1 to 255 of the logical view to be deleted.
    Specify an asterisk to delete all logical views for the specified SYSOUT group.
    This parameter cannot be specified with the GEN and SEQ parameters.
  • INDEX
    Deletes any created page indexes for the report on the disk database
    The
    View
    online cross report indexing capability uses page indexes on disk. (The page index definitions still exist with the logical views for the report).
  • FORCE
    Deletes a SYSOUT in OPEN status after prompting the user to verify that the job is no longer running.
    Note
    : If the job is still processing the report, issuing FORCE could cause corruption of database data. Be sure that the job is not processing before issuing a DELETE FORCE for an OPEN report.
  • RESOURCE=
    Specifies the name of an AFP RESOURCE rather than a Report ID.
    Do not specify ID= when using the RESOURCE parameter.
    This parameter allows an AFP resource to be deleted. This type of control statement is generated through SARTSLST.
  • DEV= sname
    Specifies 1-12 character synonym name for device to be deleted. No other DELETE parameters are allowed.
  • FILT= fname
    Specifies 1-8 character name for filter to be deleted. No other DELETE parameters are allowed.
EPRINT
The
Deliver
-to-
View
interface provides a function that is invoked by the EPRINT control statement to print reports archived directly from
Deliver
.
Syntax:
/EPRINT ACIFRES=Y|N ADDRESS=('
text
'…) BANNER=
xxxxxxxx
BUILDING=
'text'
BURST=Y|N CHARS=(
xxxx xxxx xxxx xxxx
) CKPTLINE=
nnnnn
CKPTPAGE=
nnnnn
CKPTSEC=
nnnnn
CLASS=
x
COLORMAP=
xxxxxxxx
COMPACT=
xxxxxxxx
COMSETUP=
xxxxxxxx
CONTROL=PROGRAM|SINGLE|DOUBLE|TRIPLE COPIES=
x
COPYG=(
nnn nnn nnn nnn nnn nnn nnn nnn
) DATACK=BLOCK|UNBLOCK|BLKCHAR|BLKPOS DEPT=
'text'
DEST=
dest.userid
DIST=((
distid distid …)/dest/writer (distid distid …)/dest/writer …
) DPAGELBL=Y|N DUPLEX=NO|NORMAL|TUMBLE FCB=
xxxx
FLASH=(
xxxx nnn
) FORM=
xxxxxxxx
FORMDEF=
xxxxxx
FORMLEN=
nn[.mmm]
IN|CM FSSDATA=
'data'
GEN=
nnnnn
HOLD=Y|N ID=
id
INDEX=
xxxxxxxx
INST=(
'text' 'text'...
) INTRAY=
nnn
IPDEST=
ipdest
LINECT=
nnn
MODIFY=(
xxxx n
) NAME=
'text'
NOTIFY=(
node.userid …)
OFFSETXB=
mmm[.nnn]
IN|CM|MM|PELS|POINTS OFFSETXF=
mmm[.nnn]
IN|CM|MM|PELS|POINTS OFFSETYB=
mmm[.nnn]
IN|CM|MM|PELS|POINTS OFFSETYF=
mmm[.nnn]
IN|CM|MM|PELS|POINTS OPTCDJ=Y|N OUTBIN=
nnnnn
OUTDISP=(
ndisp,adisp
) OUTPUT=
name
OVERLAYB=
xxxxxxxx
OVERLAYF=
xxxxxxxx
PAGE=(
nnn nnn nnn nnn nnn nnn nnn nnn nnn
) PAGEDEF=
xxxxxx
PIMSG=(Y|N,
nnn)
PORTNO=
nnnnn
PRMODE=
xxxxxxxx
PRSET=
xxxxxxx
PRTERROR=DEFAULT|QUIT|HOLD PRTOPTNS=
xxxxxxxxxxxxxxxx
PRTQUEUE=
'queue'
PRTY=
nnn
RECORD=(
nnn nnn nnn nnn nnn nnn nnn nnn nnn
) RESFMT=P240|P300 RETAINF=
hhhh:mm:ss
|FOREVER RETAINS=
hhhh:mm:ss
|FOREVER RETRYL=
nnn
RETRYT=
hhhh:mm:ss
ROOM=
'text'
SELECT=
xxxxxxxx
SEQ=
nnnnn
SYSAREA=Y|N TFILTER=
xxxxxxxx
TITLE=
'text'
TVIEW=
xxxxxxxx
UCS=
xxxx
USERDATA=(
'text'
…) USERLIB=(
lib …)
VIEW=(
nnn,viewid,userid
) WRITER=
xxxxxxxx
where:
  • ACIFRES=Y|N
    Specifies whether ACIF AFP resources can be included in the print data stream. This parameter defaults to the value set in SARINIT.
  • ADDRESS=('text' …)
    Specifies deliver address lines for the SYSOUT.
    You can specify 1 to 4 deliver address lines that contain up to 60 text characters separated by blanks and/or commas and enclosed in parentheses.
  • BANNER=xxxxxxxx
    Specifies an optional model banner page name to be used to override the one defined for the report in the
    Deliver
    database.
  • BUILDING='text
    Specifies the building identification for the SYSOUT. You can specify up to 60 text characters for building identification.
  • BURST=Y|N
    Specify Y or N to indicate whether the report destined for the 3800 needs to be burst.
  • CHARS=(xxxx xxxx xxxx xxxx)
    Specifies an optional set of character arrangement table names for the 3800 printer to override the ones used to print the report.
    A value of 1 to 4 names separated by one or more blanks and/or commas and enclosed in parentheses can be specified.
  • CKPTLINE=nnnnn
    Specifies the maximum lines in a logical page. A range of 0 to 32767 can be specified.
  • CKPTPAGE=nnnnn
    Specifies the number of logical pages before JES checkpoints data. A range of 1 to 32767 can be specified.
  • CKPTSEC=nnnnn
    Specifies the number of seconds before JES checkpoints data. A range of 1 to 32767 can be specified.
  • CLASS=x
    Specifies an optional class to override the one used to print the report.
  • COLORMAP=xxxxxxxx
    Specifies the color translation resource object.
  • COMPACT=xxxxxxxx
    Specifies the compaction table for sending SYSOUT to SNA terminal.
  • COMSETUP=xxxxxxxx
    Specifies the microfiche setup resource.
  • CONTROL=value
    Specifies line spacing. Valid values are:
    • PROGRAM
      Indicates each logical record contains a carriage control character.
    • SINGLE
      Indicates single spacing.
    • DOUBLE
      Indicates double spacing.
    • TRIPLE
      Indicates triple spacing.
  • COPIES=Y|N
    Specify Y or N to indicate whether the copies value is to be used when printing the report for the report recipients.
  • COPYG=(nnn nnn nnn nnn nnn nnn nnn nnn)
    Specifies an optional set of copy groups for the 3800 printer to override the ones used to print the report.
    A value of one to eight copy groups separated by one or more blanks and/or commas and enclosed in parentheses can be specified. Each copy group value must be in the range of 1 to 255.
  • DATACK=value
    Specifies how printer errors are to be handled. Valid values are:
    • BLOCK
      Indicates errors are not reported.
    • UNBLOCK
      Indicates errors are reported.
    • BLKCHAR
      Indicates print errors are blocked.
    • BLKPOS
      Indicates data errors are blocked.
  • DEPT='text'
    Indicates department identification for the SYSOUT. You can specify up to 60 text characters for department identification.
  • DEST=dest.userid
    Specifies the SYSOUT destination and optional user ID of the report.
    You can specify up to eight characters for destination and up to eight characters for the optional user ID.
  • DIST=((distid distid)/dest/writer (distid distid/dest/writer)
    Specifies an optional, complete definition of distribution specifications to override the one defined for the report in the
    Deliver
    database.
    Specify a list of distribution identifiers or groups of distribution identifiers. A group of distribution identifiers consists of a list of distribution identifiers separated by one or more blanks and/or commas and enclosed in parentheses.
    Note: If distid contains an embedded blank, parenthesis, quote, or a comma, enclose it in quotes (single or double). Any quote within the Dist-ID must be entered as a pair of quotes because a non-paired quote ends the ID; for example, if the value is JIM’S DESK, enter it as ‘JIM’’S DESK’ or "JIM’S DESK".
    Only one copy of the report is written to spool for a group. The model banner page for the group then references all the distribution identifiers in the group.
    An optional remote print destination and writer name can be specified as follows:
    • For any single, non-grouped distribution identifier
    • Any group of distribution identifiers
    Follow the distribution identifier or group with a slash (/), the destination with another slash (/), and the writer name. The destination can be a synonym created using the online DEFine DEVice command.
  • DPAGELBL=Y|N
    Specifies whether a security label is to be output.
  • DUPLEX=value
    Specifies whether the report is printed on one or both sides of the paper. Valid values are:
    • NO
      Prints on one side only.
    • NORMAL
      Rotates the physical page about the Y axis, which allows for binding on the long side of the sheet.
    • TUMBLE
      Rotates the physical page about the X axis, which allows for binding on the short side of the sheet.
  • FCB=xxxx
    Specifies an optional forms control image to override the one used to print the report.
  • FLASH=(xxxx nnn)
    Specifies an optional forms flash overlay name and flash count for the 3800 printer to override those used to print the report.
    The forms flash overlay name and flash count are separated by one or more blanks and/or commas and are enclosed in parentheses.
  • FORM=xxxxxxxx
    Specifies an optional forms name to override the one used to print the report.
  • FORMDEF=xxxxxx
    Specifies a library member that contains statements to control printing of the SYSOUT data on the 3800 printer.
    The statements can specify overlay forms, page location for overlays, and page format suppressions that can be activated.
  • FORMLEN=nn[.mmm]IN|CM
    Specifies length and unit of measurement of the form.
  • FSSDATA='data'
    Specifies Functional Subsystem data. You can specify up to 127 characters for functional subsystem data.
  • GEN=nnnnn
    Specifies the absolute or relative number of the generation of the report to be printed.
    If omitted, the most recently archived report for the report identifier is printed.
  • HOLD=Y|N
    Specifies whether the report is to be placed on the held queue for printing. If omitted, HOLD=N is assumed.
  • ID=id
    Specifies the SYSOUT ID/report identifier of the group to be printed. You can specify 1 to 32 characters for ID.
    Note
    : If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double).. Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT". This parameter is required.
  • INDEX=xxxxxxxx
    Specifies the index value associated with this print request.
  • INST=('text' 'text')
    Specifies an optional, complete set of special instructions to override the set defined for the report in the
    Deliver
    database.
    Multiple lines of instruction text can be specified as a list of the text lines separated by blanks and/or commas and enclosed in parentheses.
    A single line of text must be enclosed within single quotation marks; a single quotation mark within the text itself must be represented by two, contiguous single quotation marks.
  • INTRAY=nnn
    Specifies the printer input tray. A range of 1 to 255 can be specified.
  • IPDEST=ipdest
    Specifies the TCP/IP routing designation. You may specify up to 124 characters of TCP/IP routing information.
  • LINECT=nnn
    Specifies the number of lines to print per page.
  • MODIFY=(xxxx n)
    Specifies an optional copy modification module name and table reference character for the 3800 printer to override those used to print the report.
    The copy modification module name and table reference character are separated by one or more blanks and/or commas and are enclosed in parentheses.
    The table reference character can have a value of 0 to 3.
  • NAME='text'
    Specifies the name to be printed on output separator pages. You can specify up to 60 text characters for the name.
  • NOTIFY=(node.userid …)
    Specifies a print notification message destination. You can specify up to four destinations for the print notification message.
  • OFFSETXB=mmm[.nnn]IN|CM|MM|PELS|POINTS
    Specifies X offset of logical page origin for the back side of the paper.
  • OFFSETXF=mmm[.nnn]IN|CM|MM|PELS|POINTS
    Specifies X offset of logical page origin for the front side of the paper.
  • OFFSETYB=mmm[.nnn]IN|CM|MM|PELS|POINTS
    Specifies Y offset of logical page origin for the back side of the paper.
  • OFFSETYF=mmm[.nnn]IN|CM|MM|PELS|POINTS
    Specifies Y offset of logical page origin for the front side of the paper.
  • OPTCDJ=Y|N
    Specify Y or N to indicate whether the report records contain table reference characters for the 3800 printer.
  • OUTBIN=nnnnn
    Specifies the output bin ID. A range of 1 to 65535 can be specified.
  • OUTDISP=(ndisp,adisp)
    Specifies the normal and abnormal output disposition. Valid values are:
    • HOLD
      Indicates SYSOUT is not printed until it is released.
    • KEEP
      Indicates SYSOUT is printed but not immediately purged.
    • LEAVE
      Indicates SYSOUT is not printed until it is released and not immediately purged once printed.
    • PURGE
      Indicates SYSOUT is deleted without printing.
    • WRITE
      Indicates SYSOUT is printed and purged.
  • OUTPUT=xxxxxxxx
    Specifies the name of the output statement to be used for printing the SYSOUT group.
    This parameter overrides the specifications of the FORMDEF, LINECT, PAGEDEF, PRMODE, and possibly, FORM parameters. The parameter (xxxxxxxx) data is specified as follows:
    • name
      stepname.name
    • stepname.procstepname.name
      An asterisk can precede the parameter data to match the JCL specification of the OUTPUT parameter.
  • OVERLAYB=xxxxxxxx
    Specifies medium overlay for back side of paper.
  • OVERLAYF=xxxxxxxx
    Specifies medium overlay for front side of paper.
  • PAGE=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)
    Specifies 1 to 9 page numbers and/or ranges of pages to be printed.
    The page numbers and/or ranges of pages are separated by one or more blanks and/or commas and are enclosed in parentheses. A range of pages is specified as two page numbers separated by a colon.
    If both PAGE and RECORD are omitted, the entire SYSOUT group is printed.
  • PAGEDEF=xxxxxx
    Specifies a library member containing statements to control the printing of the SYSOUT data on the 3800 printer.
    The statements can specify logical page length, width, fonts, and page segments.
  • PIMSG=(Y|N,nnn)
    Specifies whether messages from a functional subsystem are to be printed and the message threshold where the system cancels printing.
  • PORTNO=nnnnn
    Specifies the TCP port number at which FSS connects to the printer. A range of 1 to 65535 can be specified.
  • PRMODE=xxxxxxxx
    Specifies the process mode required for printing the SYSOUT group.
  • PRSET=xxxxxxx
    Specifies the name of the printer setup member used to print this report.
  • PRTERROR=value
    Specifies an action for print error. Valid values are:
    • DEFAULT
      Indicates that a standard action is taken when a terminating error occurs during printing.
    • QUIT
      Indicates that the SYSOUT is released when a terminating error occurs during printing.
    • HOLD
      Indicates that the SYSOUT is placed in held status when a terminating error occurs during printing.
  • PRTOPTNS=xxxxxxxxxxxxxxxx
    Specifies the named entity of print options for FSS.
  • PRTQUEUE='queue'
    Specifies a target print queue for FSS. You can specify up to 127 characters for print queue.
  • PRTY=nnn
    Specifies the priority to assign to this print request.
  • RECORD=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)
    Specifies one to nine record numbers and/or ranges of records to be printed
    The record numbers and/or ranges of records are separated by one or more blanks and/or commas and are enclosed in parentheses. A range of records is specified as two record numbers separated by a colon.
    If both PAGE and RECORD are omitted, the entire SYSOUT group is printed.
  • RESFMT=P240|P300
    Specifies the resolution used to format the print. Valid values are:
    • P240
      Indicates 240 pels per inch resolution.
    • P300
      Indicates 300 pels per inch resolution.
  • RETAINF=hhhh:mm:ss|FOREVER
    Specifies the failed transmission retain time.
  • RETAINS=hhhh:mm:ss|FOREVER
    Specifies the successful transmission retain time.
  • RETRYL=nnn
    Specifies the maximum number of transmission retries.
  • RETRYT=hhhh:mm:ss
    Specifies the length of time to wait between retries.
  • ROOM='text'
    Specifies a room identification. You can specify up to 60 text characters for room identification.
  • SELECT=xxxxxxxx
    Specifies the page separation index value for selecting pages to print.
    If the value contains any of the special characters: blank, comma, or single quote, the index value must be enclosed within single or double quotes.
  • SEQ=nnnnn
    Specifies the absolute or relative SYSOUT sequence number of the report to be printed.
    • If omitted, the most recently archived report of the identifier and generation specified is printed.
    • If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
    • If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.
    • EX: SEQ=-1
      The second most recently archived SYSOUT is processed regardless of its generation and sequence number.
    • EX: SEQ=-2
      The third most recently archived SYSOUT is processed regardless of its generation and sequence number.
  • SYSAREA=Y|N
    Specifies whether the system is to reserve a system area on each page of output.
  • TFILTER=xxxxxxxx
    Specifies the temporary filter name used to print this report where the format is yyydddseq#.
  • TITLE='text'
    Specifies a title identification. You can specify up to 60 text characters for text identification.
  • TVIEW=xxxxxxxx
    Specifies the temporary view name used to print this report where the format is yyydddseq#.
  • UCS=xxxx
    Specifies an optional, special character set name to override the one used to print the report.
  • USERDATA=('text' …)
    Specifies user data for the SYSOUT. You can specify 1 to 16 user data lines containing up to 60 text characters separated by blanks and/or commas and enclosed in parentheses.
  • USERLIB=(lib …)
    Specifies up to eight libraries containing APF resources.
  • VIEW=(nnn, viewid,userid)
    Specifies the view format to use to print the report, where:
    • nnn
      View number (1 to 255).
    • viewed
      Optionally specifies the ID of a public, private, or global view.
      Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".
    • userid
      Optionally specifies the user ID for private view.
  • WRITER=xxxxxxxx
    Specifies the external writer name to be used for printing the SYSOUT group.
Notes:
The number of printed lines can be limited by the
View
OUTLIM initialization parameter.
EXTRACT
The EXTRACT control statement specifies that a SYSOUT archived to
View
is to have fields extracted from it by
Balancing
.
Syntax:
/EXTRACT GEN=
nnnnn
ID=
id
INBSSN=xxxxxxxxxx PAGE=(
nnn nnn nnn nnn nnn nnn nnn nnn nnn)
SEQ=
nnnnn
Where:
  • GEN=nnnnn
    Specifies the absolute or relative number of the generation of the report to be accessed by
    Balancing
    .
    If omitted, the most recently archived report for the report identifier is used.
  • ID=id
    Specifies the SYSOUT ID/report identifier of the group.
    This value can be 1 to 32 characters.
    Note
    : If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".
    This parameter is required.
  • INBSSN=xxxxxxxxxx
    Specifies the
    Balancing
    LSERV subsystem name.
  • PAGE=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)
    Specifies 1 to 9 page numbers and/or ranges of pages where data fields are to be extracted by
    Balancing
    .
  • SEQ=nnnnn
    Specifies the absolute or relative sequence number of the SYSOUT group to be accessed by
    Balancing
    .
    If omitted, the most recently archived group for the ID and GEN specified is used. This operand is ignored when GEN is omitted.
INDEX
The INDEX control statement creates a page index for a SYSOUTs, using all page separation criteria defined online. Page separation criteria are defined with the logical views of a SYSOUT.
An archived report must reside on the
View
primary disk database to be indexed.
Syntax:
/INDEX GEN=
nnnnn
ID=
id
SEQ=
nnnnn
where:
  • GEN=nnnnn
    Specifies the absolute or relative number of the generation of the report to be indexed.
    If omitted, the most recently archived report for the report identifier is used.
  • ID=id
    Specifies the SYSOUT ID/report identifier of the group
    The value can be 1 to 32 characters.
    Note
    : If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".
    This parameter is required.
  • SEQ=nnnnn
    Specifies the absolute or relative sequence number of the SYSOUT group to be indexed
    • If omitted, the most recently archived group for the ID and GEN specified is used.
    • If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
    • If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.
    • EX: SEQ=-1
      The second most recently archived SYSOUT is processed regardless of its generation and sequence number.
    • EX: SEQ=-2
      The third most recently archived SYSOUT is processed regardless of its generation and sequence number.
LIST
The LIST control statement produces a listing of archived SYSOUT or user IDs. The report is output to the REPORT DD statement.
SYSOUT Listing
The listing of archived SYSOUT groups can be for an individual SYSOUT group, a complete generation of archived SYSOUT, or all archived SYSOUT. The listing contains the following information:
  • SYSOUT ID
  • Job name
  • Job ID
  • Generation number
  • SYSOUT sequence number
  • Archive date and time
  • Location of the SYSOUT (disk, tape, or temporary disk)
  • Number of lines archived - shown in thousands (K) if it exceeds 10 million
  • Number of pages archived - shown in thousands (K) if it exceeds 10 million
  • Number of blocks written to disk
  • Exception condition
  • Tape sequence number
  • DR Tape sequence number
    If FORMAT=FORM is specified, the Exception condition and Tape sequence number are replaced by the form name associated with the SYSOUT ID.
The following is a SYSOUT listing generated by the LIST control statement:
11/10/2013 10:20:15 CA View Output Archival and Viewing (nn.n) Page 1 SARBCT Batch Processing Utility - Sysout Archival Listing ID Jobname Jobid Gen Seq Arc Date Arc Time Loc Lines Pages Blocks Xcode Tseq DRseq -------------------------- -------- -------- ----- ----- ---------- -------- ---- -------- ------- ------ ------- ----- ----- ASTALLEG ASTALLEG JOB05544 26 7 12/18/2010 13:42:01 DISK 24 6 1 BSPURRI1 BSPURRI1 JOB05668 26 1458 01/11/1999 13:37:10 DISK 18712312K 1231587K 12143K 0016 GTHDEMO--R01 HASGADM1 JOB12795 32 1 12/13/2012 15:17:12 TAPE 1046 1 0 8 8 HASGAINI HASGAINI JOB26529 35 1 01/12/2013 15:51:02 PTAP 352 9 0 7 6
where:
  • Lines
    If the number of lines exceeds 999,999,999, the number of lines is displayed in thousands, that is nnnnnnnnK.
  • Pages
    If the number of pages exceeds 99,999,999, the number of pages will be display in thousands, that is nnnnnnnK.
  • DASDBlocks
    If the DASD Blocks exceeds 999,999, the number of DASD Blocks is displayed in thousands, that is nnnnnK.
User ID Listing
The listing of user IDs can be for an individual user ID, a group of user IDs, or all user IDs. The listing contains the following information:
  • User ID
  • User ID password
  • Master capability indicator
  • Generation number
  • Distribution identifier validation mask
  • Distribution identifier
  • Mode access indicator
  • Current mode
  • Default banner name
    The following is a user ID listing generated by the LIST control statement:
11/10/2013 18:26:47 CA View Output Archival and Viewing (nn.n) Page 1 SARBCT Batch Processing Utility - Userid Listing --- Last Access --- AEESSJ Userid Password Date Time M Mask Distid O O Mode L Banner Printer -------- -------- ---------- -------- - ------------------------ ------------------------ ----- ---- -- -------- -------- AMARZO 11/09/2013 16:05:58 N AMARZO AMARZO YYYYN ALL DEFAULT PRT72 CUST01 11/06/2013 11:29:14 N CUST01 CUST01 YYYYN ALL DEFAULT LOCAL10
Syntax:
/LIST EXCP=
x
FORMAT=FORM GEN=
nnnnn
ID=
id
USER=
xxxxxxxx
where:
EXCP=x
Specifies whether EXCEPTIONS are listed.
  • Y
    Lists only those SYSOUT groups with exceptional conditions.
  • N
    Lists those SYSOUT groups without exceptional conditions.
  • A
    Lists all SYSOUT groups.
  • FORMAT=FORM
    Specifies that the alternate format SYSOUT list is to be displayed.
    If omitted the standard SYSOUT list is produced.
    This parameter cannot be specified with the USER or View parameter.
  • GEN=nnnnn
    Specifies the absolute or relative number of the generation for which SYSOUT is listed.
    If omitted, only the most recent generation is listed. To list SYSOUT for all generations, specify an asterisk as the generation number.
    This parameter cannot be specified with the USER or View parameter.
  • ID=id
    Specifies the SYSOUT ID of the SYSOUT group to be listed.
    The value can be 1 to 32 characters.
    A generic ID can be specified by appending an asterisk to the generic ID. If omitted, all SYSOUT IDs are listed.
    This parameter cannot be specified with the USER or View parameter.
    Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".
  • USER=xxxxxxxx
    Specifies the name of the user ID or user IDs to be listed.
    A generic ID can be specified by appending an asterisk to the identifier.
    If omitted, all user IDs are listed.
    This parameter cannot be specified with the EXCP, FORMAT, GEN, and ID parameters.
Note:
The number of printed lines can be limited by the
View
OUTLIM initialization parameter.