Batch Processing › SARBCH Control Statements › CHANGE

CHANGE

The CHANGE control statement changes various attributes of a SYSOUT group, including the archival date, that has already been archived to the CA View database.

You can use this statement if a SYSOUT was archived with inappropriate print attributes, or if the tape it was backed up to has been destroyed, and its internal status must be changed to NOT BACKED UP.

You can modify the following attributes with SARBCH CHANGE:

• All PRINT attributes
• BACKUP

  Specifies whether the SYSOUT has been backed up to tape from disk.

• USERDATA

  Contains a 20-byte user data field, typically accounting data.

• USERFLD

  Contains any user comments to be displayed with the SYSOUT in the CA View selection lists.

Syntax:

/CHANGE ADDRESS=('text'…)
        ARCHDATE=mm/dd/yyyy
        ARCHTIME=hh:mm:ss
        BACKUP=OFF
        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=nnn
        COPYG=(nnn nnn nnn nnn nnn nnn nnn nnn)
        DATACK=BLOCK|UNBLOCK|BLKCHAR|BLKPOS
        DEPT='text'
        DEST=dest.userid
        DPAGELBL=Y|N
        DSK2VID=nnn
        DUPLEX=NO|NORMAL|TUMBLE
        FCB=xxxx
        FLASH=(xxxx nnn)
        FORM=xxxxxxxx
        FORMDEF=xxxxxx
        FORMLEN=nn[.mmm]IN|CM
        FSSDATA='data'
        GEN=nnnnn
        ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        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)
        OVERLAYB=xxxxxxxx
        OVERLAYF=xxxxxxxx
        OWNER=userid
        PAGEDEF=xxxxxx
        PGMRNAME=name
        PIMSG=(Y|N,nnn)
        PORTNO=nnnnn
        PRMODE=xxxxxxxx
        PRTERROR=DEFAULT|QUIT|HOLD
        PRTOPTNS=xxxxxxxxxxxxxxxx
        PRTQUEUE='queue'
        PRTY=nnn
        RESFMT=P240|P300
        RESOURCE=xxxxxx
        RETAINF=hhhh:mm:ss|FOREVER
        RETAINS=hhhh:mm:ss|FOREVER
        RETRYL=nnn
        RETRYT=hhhh:mm:ss
        ROOM='text'
        SEQ=nnnnn
        SYSAREA=Y|N
        TAPECNT=nnnnn
        THRESHOLD=nnnnnnnn
        TITLE='text'
        UCS=xxxx
        USERDATA=('text' …)
        USERFLD='text'
        USERINFO='data'
        USERLIB=(lib …)
        WRITER=xxxxxxxx

where:

ADDRESS=('text' …)

Specifies deliver address lines for the SYSOUT You can specify one to four deliver address lines containing up to 60 text characters separated by blanks and/or commas and enclosed in parentheses.

ARCHDATE=mm/dd/yyyy

Specifies the new archival date of the report.

Note:

• The report must be on 'disk' before the /CHANGE statement can be used. The report can be recently archived, retained, or reloaded to disk. The /CHANGE ARCHDATE function sets the report to 'Backup=Off' and the report is backed up during the next backup cycle.
• The archival time can be specified with ARCHTIME. If ARCHTIME is not specified, the value defaults to twelve noon (12:00:00) to help identify archival date changes
• If ARCHCHG baseyear is not specified, the sequencing of reports within a generation may not be ordered correctly.
• If daily backup cycles are not run, a database generation can span multiple days. Reports within a database generation are assigned a sequential number beginning with 'one'. If a specific database generation has three daily reports numbered 1, 2, and 3, and a report is back-dated to the same date as sequence 2, but lower than sequence 3, the report appears in the SYSOUT Selection List behind report sequence 3. This happens because the existing reports cannot be re-sequenced.
• Annotations and Book Mark are re-sequenced with the report's generation and sequence numbers.
• Review report retention parameters prior to back-dating a report. Because it is possible that the age and generation of the report are beyond the control of the existing ERO or NGEND/NGENT settings, the report can be deleted during the next backup cycle. If using ERO, the parameters for the report are reset as part of the process. Set the EROPRO Initialization Parameter to YES so that back-dated reports are always evaluated for ERO Retention.
• If using the SARINIT ARCHCHG=baseyear initialization parameter, the date specified in ARCHDATE must not precede the value specified for baseyear.

A Subtype 35 (Archival Date Change) Metric SMF Record is created if the SMFTYPE Initialization Parameter is set to a valid SMF Record Type which enabled the Metrics Feature. This SMF record can be used as an Audit Trail to determine if report dates have been modified.

ARCHTIME =hh:mm:ss

Specifies the new archival time of the report.

Note:

• The report must be on 'disk' before the /CHANGE statement can be used. The report can be recently archived, retained, or reloaded to disk. The /CHANGE ARCHDATE function sets the report to 'Backup=Off', and the report is backed up during the next backup cycle.
• If ARCHTIME is not specified, the ARCHTIME defaults to twelve noon (12:00:00) to help identify archival date changes.
• If using the SARINIT ARCHCHG=baseyear initialization parameter and if ARCHDATE is the current date, the time specified in ARCHTIME must not be greater than the current time.

BACKUP=OFF

Specifies that the backup indicator for the SYSOUT is to be turned off.

The indicator is turned on when a SYSOUT is backed up. If a SYSOUT is backed up to tape, and that tape is lost or destroyed, you must specify BACKUP=OFF, to cause the CA View backup cycle to back up the SYSOUT again.

BUILDING='text'

Specifies the building identification for the SYSOUT.

You can specify up to 60 text characters for building identification.

BURST=Y|N

Specifies whether the paper is to be burst on the 3800 printer when printed.

CHARS=(xxxx xxxx xxxx xxxx)

Specifies a set of character arrangement table names for the 3800 printer for the SYSOUT.

You can specify a value of one to four names separated by one or more blanks and/or commas and enclosed in parentheses.

CKPTLINE=nnnnn

Specifies the maximum lines in a logical page. You can specify a range of 0 to 32767.

CKPTPAGE=nnnnn

Specifies the number of logical pages before JES checkpoints data. You can specify a range of 1 to 32767.

CKPTSEC=Nnnnn

Specifies the number of sections before JES checkpoints data. You can specify a range of 1 to 32767.

CLASS=x

Specifies a class for the SYSOUT.

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

Each logical record contains a carriage control character.

SINGLE

Single spacing

DOUBLE

Double spacing

TRIPLE

Triple spacing

COPIES=nnn

Specifies a number of copies to override the one used to print the SYSOUT. A range of 1 to 255 can be specified.

COPYG=(nnn nnn nnn nnn nnn nnn nnn nnn)

Specifies an optional set of copy groups for the 3800 printer to override those used to print the SYSOUT.

You can specify a range of one to eight copy groups separated by one or more blanks and/or commas and enclosed in parentheses. 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 an optional destination and an optional user ID to override the one used to print the SYSOUT.

You can specify up to eight characters for destination and up to eight characters for the user ID. 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.

DSK2VID=nnn

Specifies the secondary disk version number. A range of 0 to 255 can be specified.

DUPLEX=value

Specifies whether the report is printed on one or both sides of paper.

Valid values are:

NO

Prints on one side only.

NORMAL

Rotates the physical page about the Y axis, which allows for binding the long side of the sheet.

TUMBLE

Rotates the physical page about the X axis, which allows for binding the short side of the sheet.

FCB=xxxx

Specifies an optional forms control image to override the one used to print the SYSOUT.

FLASH=(xxxx nnn)

Specifies an optional forms flash overlay name and flash count for the 3800 printer to override those used to print the SYSOUT.

The forms flash overlay name and copy 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 SYSOUT.

FORMDEF=Xxxxxx

Specifies a library member containing 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 the 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 for which SYSOUT is affected by the CHANGE statement. If omitted, the most recently archived SYSOUT group for the ID is affected.

ID=id

Specifies the SYSOUT ID of the group to be affected by the CHANGE statement.

You can specify 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.

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 can specify up to 124 characters of TCP/IP routing information.

LINECT=nnn

Specifies the maximum number of lines to be printed on each output 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 SYSOUT.

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 range of 0 to 3.

NAME='text'

Specifies the name to print 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 an X offset of logical page origin for the back side of paper.

OFFSETXF=mmm[.nnn]IN|CM|MM|PELS|POINTS

Specifies an X offset of logical page origin for the front side of paper.

OFFSETYB=mmm[.nnn]IN|CM|MM|PELS|POINTS

Specifies a Y offset of logical page origin for the back side of paper.

OFFSETYF=mmm[.nnn]IN|CM|MM|PELS|POINTS

Specifies a Y offset of logical page origin for the front side of paper.

OPTCDJ=Y|N

Specifies an optional override as to whether the SYSOUT records contain table reference characters for the 3800 printer. Valid values are Y or N.

OUTBIN=nnnnn

Specifies output bin ID. You can specify a range of 1 to 65535.

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 it is printed.

PURGE

Indicates SYSOUT is deleted without printing.

WRITE

Indicates SYSOUT is printed and purged.

OVERLAYB=xxxxxxxx

Specifies medium overlay for the back side of paper.

OVERLAYF=xxxxxxxx

Specifies medium overlay for the front side of paper.

OWNER=userid

Specifies the user ID that created the report.

PAGEDEF=xxxxxx

Specifies a library member containing statements to control printing of the SYSOUT data on the 3800 printer.

The statements can specify logical page length, width, fonts, and page segments.

PGMRNAME=name

Specifies the programmer name.

PIMSG=(Y|N,nnn)

Specifies whether messages from a functional subsystem are to be printed and the message threshold at which the system is to cancel printing.

PORTNO=nnnnn

Specifies 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.

PRTERROR=value

Specifies an action for print error.

Valid values are:

DEFAULT

Indicates a standard action is taken when a terminating error occurs during printing

QUIT

Indicates the SYSOUT is released when a terminating error occurs during printing

HOLD

Indicates the SYSOUT is placed in held status when a terminating error occurs during printing

PRTOPTNS=xxxxxxxxxxxxxxxx

Specifies 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.

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

RESOURCE=

Specifies the name of an AFP RESOURCE rather than a Report ID.

Do not specify ID= when using the RESOURCE parameter.

This parameter along with the BACKUP=OFF parameter allow an AFP resource to be recreated on tape. This type of control statement is generated through SARTSLST.

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.

SEQ=nnnnn

Specifies the absolute or relative SYSOUT sequence number of the SYSOUT group to be affected by the CHANGE statement

• If omitted, the most recently archived SYSOUT group for the ID and generation specified is affected.
• 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

TAPECNT=nnnn

Specifies the number of tapes that the SYSOUT resides on. A range of 1 to 9999 can be specified.

THRESHLD=nnnnnnnn

Specifies the maximum size of a SYSOUT data set. A range of 1 to 99999999 can be specified.

TITLE='text'

Specifies a title identification. You can specify up to 60 text characters for title identification.

UCS=xxxx

Specifies an optional special character set name to override the one used to print the SYSOUT

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.

USERFLD='text

Specifies user comments to be displayed with this SYSOUT on the CA View selection lists

To include any spaces within the comment, enclose the entire comment in quotes, as in USERFLD='THIS IS MY COMMENT'.

USERINFO='data'

Specifies up to 20 characters of user information (typically accounting data)

USERLIB=(lib …)

Specifies up to eight libraries containing APF resources

WRITER=xxxxxxxx

Specifies an external writer name.

Default:

If you specify a parameter without a value, that parameter is set to blanks. For example, if you specify the following, the PAGEDEF field is set to blanks:

PAGEDEF=