Titling of Printer Backup Files

MOREBACKUPFILES Option Is Set

If the MOREBACKUPFILES option of the OP (Options) system command is set and no title is specified by the process that created a backup file, the system automatically assigns the backup file a title of the following form:

*BD/<mix number>/..../<12-digit file number>/
<internal name> ON <backup family>

In this title, the *BD node indicates that this is a printer backup file. On a system running the Secure Accountability Facility with the USERCODEDBACKUP option set to TRUE, the backup file titles are prefixed with the usercode of the process, rather than an asterisk (*).

The first node of the title is followed by one or more nodes that store mix numbers. The first of these nodes contains the mix number of the originating job or the session number of the originating session. Other mix number nodes, if there are any, contain the mix numbers for other ancestors of the process, in order, from eldest to youngest. The last of the mix number nodes contains the mix number of the process itself. If there is only one mix number node, the backup file was created directly by a job or session. Each mix number node is padded on the left with enough zeros to bring the node to 7 digits in length.

The file number node is a 12-digit number that indicates the chronological order of this backup file compared to other backup files produced by the same process. For example, suppose a process declares a backup file with an INTNAME of A and another with an INTNAME of B. If the process opens and closes A three times, the system creates multiple backup files whose titles end with 000000000000/A, 000000000001/A, and 000000000002/A. If the process then opens B, the system creates a backup file whose title ends with 000000000003/B.

The last node of the title stores a file name. The name is up to 17 characters of the FILENAME file attribute, which can be assigned by the process. If FILENAME is not assigned, FILENAME defaults to the value of the INTNAME file attribute. If INTNAME is not assigned, its value defaults to the file identifier used in the file declaration.

MOREBACKUPFILES Option Is Not Set

If the MOREBACKUPFILES option of the OP (Options) system command is not set and no title is specified by the process that created a backup file, the system automatically assigns the backup file a title of the following form:

*BD/<mix number>/..../<file number><internal name> ON <backup family>

In this title, the *BD node indicates that this is a printer backup file. On a system running the Secure Accountability Facility with the USERCODEDBACKUP option set to TRUE, the backup file titles are prefixed with the usercode of the process, rather than an asterisk (*).

The first node of the title is followed by one or more nodes that store mix numbers. The first of these nodes contains the mix number of the originating job or the session number of the originating session. Other mix number nodes, if there are any, contain the mix numbers for other ancestors of the process, in order, from eldest to youngest. The last of the mix number nodes contains the mix number of the process itself. If there is only one mix number node, the backup file was created directly by a job or session. Each mix number node is padded on the left with enough zeros to bring the node to 7 digits in length.

The last node of the file name stores a file number and a name. The name is the first fourteen characters of the FILENAME file attribute, which can be assigned by the process. If FILENAME is not assigned, FILENAME defaults to the value of the INTNAME file attribute. If INTNAME is not assigned, its value defaults to the file identifier used in the file declaration.

The file number is a 3-digit number that indicates the chronological order of this backup file compared to other backup files produced by the same process. For example, suppose a process declares a backup file with an INTNAME of A and another with an INTNAME of B. If the process opens and closes A three times, the system creates multiple backup files whose titles end with 000A, 001A, and 002A. If the process then opens B, the system creates a backup file whose title ends with 003B.

Note that if a process attempts to create a backup file that would be numbered higher than 999, the system discontinues the process with the error TOO MANY BACKUP FILES. The HISTORYTYPE value is 4 (DSEDV), the HISTORYCAUSE value is 8 (SOFTIOERRCAUSEV), and the HISTORYREASON value is 115.

For more information on the OP (Options) system command refer to the System Commands Reference.

The backup family is the family determined by the rules discussed under Storing Printer Backup Files Temporarily earlier in this section.

Note that the backup file title can be affected by the task attributes discussed under Other Print-Related Task Attributes later in this section.