Syntax
- PDEF ---~
~_r---~~~I I
I---,~
( .L<file attribute/print'modifier assignment::l )-I-=-.J
1-*---1
' - - . _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ - - - 1Explanation
The PDEF or PRINTDEF AULTS command allows default print attributes to be specified for the tasks initiated from the current CANDE session. This command can interrogate or change the current PRINTDEF AULTS attributes. The
PRINTDEFAULTS attributes are supplied on all task executions explicitly initiated by the user and on CANDE-initiated tasks, such as WRITE. Additionally, the current PRINTDEFAULTS attributes can be overridden by an explicit specification in a task-initiated statement, such as RUN or COMPILE. Note that PRINTDEFAULTS attributes cannot be compiled in the program that is being compiled via the
COMPILE command entered through CANDE. A specification to override the session PRINTDEFAULTS attributes applies only to the compiler task itself, not to the program being compiled.
The PRINTDEFAULTS attributes do not apply to the current CANDE session itself and, therefore, cannot be used to control the printing of the job summary for that session. When the job summary is created after a session terminates, it is sent to the destination of the first backup file associated with the session. If no backup file is associated with the session, the job summary is sent to the default pool of printers.
A < file attribute/print modifier assignment> is any valid PRINTDEF AUL TS file attribute or print modifier as defined in the A Series Print System (PrintS/ReprintS) Administration, Operations, and Programming Guide. Refer to the information on printing-related file attributes in the Print System Guide for a list of the supported PRINTDEF AUL TS file attributes and their uses. Refer to the information on print modifiers in the Print System Guide for information about PRINTDEF AULTS print modifiers. Note that even though SECURITYTYPE is a valid printer backup file attribute/modifier, it cannot be specified in a PRINTDEFAULTS file attribute or print modifier assignment.
The default PRINTDEFAULTS attributes for a particular usercode are determined by the PRINTDEFAULTS entry for that usercode in the USERDATAFILE. To cPange the PRINTDEFAULTS attribute in the USERDATAFILE, the MAKEUSER utility must be invoked by the installation. Refer to the Security Administration Guide for additional information about MAKEUSER.
,~
The default PRINTDEFAULTS attributes for a given usercode are set at the beginning of each session associated with that usercode. They can be overridden during a session by the PRINTDEFAULTS command.
PDEF Command (cont.)
3-120
When PDEF is the only input entered, CANDE reports the CWTent value of the PRINTDEF AULTS attributes.
The asterisk (*) causes the current value of the PRINTDEF AULTS attributes to return to the default of the usercode associated with the session.
The period (.) causes the session PRINTDEFAULTS attributes to be set to null. In this case, PRINTDEF AULTS attributes are not supplied by CANDE on any task execution request.
If the PRINTDEFAULTS attributes are explicitly changed during a session, those attributes remain in effect until the session is terminated or until they are changed by another PRINTDEFAULTS action.
If the PRINTDEFAULTS attribute DESTINATION is specified for the user's session, and the CANDE command DESTNAME is issued with a station name, the PRINTDEFAULTS DESTINATION value takes precedence. The following message is displayed when either DESTNAME or PRINTDEFAULTS DESTINATION is specified or changed and the other is already specified:
WARNING: PRINTDEFAULTS DESTINATION OVERRIDES DESTNAME.
This warning is also displayed at CANDE log-on time if both CANDEDESTNAME and PRINTDEFAULTS are specified for the user in the USERDATAFILE.
When the PRINTDEFAULTS attributes are specified in a task-initiating statement (for example, COMPILE, EXECUTE, RUN, and UTILITY), the new value
overrides the former value for the session for that request only. No abbreviation for PRINTDEFAULTS is accepted when it is used as a task-initiating command. (Refer to the COMPILE, EXECUTE, RUN, and UTILITY statements for the correct syntax.) Examples
PDEF.
PDEF = (BANNER=TRUE, NOTE=IIHEY THERE!") PDEF*
8600 1500-000
PRINT Command
Syntax
- PRINT -.L<print
specification;>->--'---~
~~---_r----~
<print modifier phrase - ~<print attribute>
L<pri nt modi fi er
< print attribute phrase>
AFTER :::;
E-<page-composition
element~ I
ARGE :::; <string>
SPOSITION :::; <print mnemonic>
KIND:::; <print mnemonic>
RTIAL - :::; - II -<print-partial
I
< print-partial string>
-.L=/
1 \-<record select i o n > - - , > - . . - - ' - - - i~/l\-<column selection~
< record selection>
~<record/line pa~
L<sequence part>
< record/line part >
-r---r---'-1r--<i nteger>
L- -
--<integer~L - -- END ~
END - - - '
<sequence part>
-- SEQUENCE
~<sequence
number>LEND - - - '
One of the mnemonic values defined in the File Attributes Reference Manual for a particular print-related file attribute, or one of the mnemonic values defined in the Print System Guide for a particular print modifier, as shown in Tables 3-6 and 3-7.
8600 1500-010
PRINT Command (cont.)
Table 3-6. Print Attributes and Corresponding Mnemonic Values
Print Attribute BACKUPKIND PRINTDISPOSITION PRINTERKIND
SECURITYTYPE TRAINID
Mnemonic Values
DONTCARE, DISK, PACK, TAPE, TAPE7, TAPE9, TAPEPE CLOSE, DIRECT, DONTPRINT, EOJ, EOT
APT, DONTCARE, D630, D630E, EPSONFX, EPSONLQ, EXPRESS, HPGL, IMAGEPRINTER, KANJIIPRINTER, LINEPRINTER, PCL3, PCL4, PCL5, PLOTTER, POSTSCRIPT, PROPRINTER, PROPRINTERXL, TTY
CONTROLLED, GUARDED, PRIVATE, PUBLIC ASCII64A, ASCII64B, ASCII72, ASCII96A, ASCI196B, BCL64, BRAZIL, B300B500, DENMARK,
DENMARKNORWAY, EBCDIC18, EBCDIC48, EBCDIC64A, EBCDIC64B, EBCDIC72, EBCDIC96, FORTRAN48, GERMANYAUSTRIA, ITALY, KATAKANA, LATIN PORTUGAL, LATINSPAIN2, LATINSPAIN3, NOID,
OCRAALPHANUMERIC, OCRANUMERIC, OCRBNUMERIC, RPG48, SWEDENFINLAND2, SWEDENFINLAND3, SWEDENOCRB, TURKEY, UK, UK3500, UK6500, YUGOSLAVIA
Table 3-7. Print Modifiers and Corresponding Mnemonic Values
Print Modifier HEADER TRAILER
Mnemonic Values
SUPPRESSED, UNCONDITIONAL
CONDITIONAL, SUPPRESSED, UNCONDITIONAL For a description of all the print attributes and the print modifiers, refer to the Print System Guide.
PRINT Command (cont.)
3-124
Explanation
CANDE recognizes the PRINT command as a Work Flow Language (WFL) command;
that is, CANDE passes the command to WFL for processing. WFL then passes a
PRINT request to the Print System (PrintS/Reprints) for asynchronous processing. For additional information, refer to the WFL Reference Manual and the Print System Guide.
Note: Because CANDE can run with different release versions of the MCP . and other software, it is possible that a feature of software might
not work as described in this Mark release version of the manual.
For example, if the Mark 4.0 version of CANDE is run with the Mark 3.9 version of the MCP and Print System (PrintS/Reprints) software, then a specification of a Mark 4.0 print attribute in the PRINTDEFAULTS assignment, as documented in the Mark 4.0 release version of this manual, might cause an error or unexpected result.
< print specification>
The print specifications in the PRINT statement specify the files to be printed or
punched. These files must be printer or punch backup files. Each print specification can include its own print attribute phrases, which affect only the specified file or directory.
<print attribute phrase>
Various print attribute phrases can be included in the PRINT statement to specify print-related file attributes that control the creation, routing, and formatting of backup files. These file attributes are described in the Print System Guide and the File Attributes Reference Manual.
< print modifier phrase>
A print modifier phrase can be included in a PRINT statement to specify additional requirements for the processing of a print request. Print modifiers can be used with a PRINT statement only through the PRINTDEFAULTS task attribute. For more information about print modifiers, see the Print System Guide.
PRINTDEFAULTS Option and <print default assignment list>
A PRINTDEFAULTS specification can be included at the end o~ a PRINT statement to provide a new set of default values for some print-related file attributes and print modifiers. These values replace defaults that were inherited from the job or from the system.
The print attribute phrases and print modifier phrases that appear in the print default assignment list are merged into the current print defaults. The - <print modifier> and - <print attribute> forms reestablish the system default value for that print modifier or print-related file attribute.
8600 1500-010
PRINT Command (cont.)
If a print specification and the PRINTDEFAULTS specification both assign values to the same print-related file attribute, then the value assigned in the print specification takes precedence. For details, see the Print System Guide.
File Attributes of < print attribute phrase>
The printer-related file attributes of the print attribute phrase are described in the File Attributes Reference Manual and the Print System Guide. A few of these printer-related file attributes are described in the following paragraphs.
PAGECOMP File Attribute
The P AGECOMP file attribute is used to specify a combination of page-composition elements to make full use of a variety of remote printer capabilities. Among
those printer capabilities that are supported by the P AGECOMP file attribute are the Hewlett-Packard Printer Command Language (PCL) and the PostScript@>
page-description languages.
Refer to the Print System Guide for more information about the types of printers that are supported and the printing capabilities that can be specified through the P AGECOMP file attribute.
PRI NT PARTIAL File Attribute
The PRINTP ARTIAL file attribute is used to specify the lines, 'records, or
sequence numbers of a file to print. Columns of the file can also be specified. The PRINTP ARTIAL file attribute enables you to print part of a file rather than the entire file. The constructs that are used to describe the PRINTP ARTIAL file attribute option are < print-partial string>, < record selection>, < column selection>, < record/line part>, < sequence part> , and < column part> .
The print-partial string specifies the portion of a file to be printed. The print-partial string must be enclosed within quotation marks (" ").
You can specify a single line or record, or a range of lines or records, of a file to be printed. When specifying either lines or records, note that records are relative to
o
(zero) and lines are relative to 1; therefore, record 0 (zero) is equivalent to line 1.LINES is the default if neither RECORD nor LINES is specified in the < record/line part> construct.
A sequence line-number or a range of sequence line-numbers can be specified for
nonbackup file types, such as symbol files or sequential files. Because backup files do not have sequence numbers, the SEQUENCE clause is not meaningful for backup files.
However, if the SEQUENCE clause is used with a backup file, a sequencing of line numbers is begun with 100 and incremented by 100, in the same way that CANDE currently does the numbering of new nonbackup files. For example, if the lines of a backup file are numbered from 1 through 10 and the PRINTP ARTIAL option of the
PostScript is a registered trademark of Adobe Systems, Inc.
PRINT Command (cont.)
3-1248
PRINT command is specified, then the line numbers of the file are displayed as 100 through 1000, incremented by 100.
Columns of a file can also be specified and must be in the range from 1 through the MAX.RECSIZE- of the file. For nonbackup files, if a column number or range is not specified, the sequence numbers are placed before the print line. If a column range is specified for a nonbackup file, then the sequence numbers that would ordinarily appear before each line do not appear.
The range of lines, records, sequence numbers, and columns must be specified in ascending order.
For exrup.ple, the following statement prints only columns 6 through 77 of lines 30 through 90 of a file named FILEl, which contains more than 90 lines:
PRINT FI LEl (PRINTPARTIAL = II LINES 30-90 COLUMN 6-77")
Refer to the File Attributes Reference Manual and the Print System Guide for more information about the PRINTP ARTIAL file attribute.
TRANSFORM file attribute
The TRANSFORM file attribute specifies a file transform, which is a general-purpose function that is applied to each line of a backup file between the time the file is created and the time it is printed. A file transform is applied to the file no matter what device prints it. A transform function associated with a device is called a device transform, which is a general-purpose function that processes all data sent to that device. A device transform is associated with a device through the use of the TRANSFORM option of the PS CONFIGURE system command. If a file transform is specified for a backup file that is routed to a printer with a device transform, the file transform is applied first, and then the device transform is applied.
Examples
In the following examples, the percent sign (%) indicates the defined continuation character; refer to the CONTINUE command for more information about the continuation character.
The following are simple PRINT statements that cause the specified files to be printed:
PRINT DRONE/CLONE;
PRINT (JOHNS)ADD/BACK ON THREEPACK, (CAY) INVENTORY/LIST;
The following PRINT statements contain a print attribute phrase as part of the print specification:
8600 1500-010
PRINT Command (cent.)