─┬ PDEF ┬──────────────────────────────────────────────────────────────► └ PD ┘ ►─┬──────────────────────────────────────────────────────────────┬─────┤ │ ┌◄──────────────────── , ────────────────────┐ │ ├─────┬─ ( ─┴─<file attribute/print modifier assignment>─┴─ ) ─┤ ├─ = ─┘ │ ├─ * ──────────────────────────────────────────────────────────┤ └─ . ──────────────────────────────────────────────────────────┘
Explanation
The PDEF 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 PRINTDEFAULTS 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 PRINTDEFAULTS file attribute or print modifier as defined in the Print System and Remote Print System 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 PRINTDEFAULTS file attributes and their uses. Refer to the information on print modifiers in the Print System Guide for information about PRINTDEFAULTS 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 change the PRINTDEFAULTS attribute in the USERDATAFILE, the MAKEUSER utility must be invoked by the installation. Refer to the System Software Utilities Operations Reference Manual 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 PDEF command.
When PDEF is the only input entered, CANDE reports the current value of the PRINTDEFAULTS attributes.
The asterisk (*) causes the current value of the PRINTDEFAULTS 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, PRINTDEFAULTS 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 PDEF 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 PDEF DESTINATION value takes precedence. The following message is displayed when either DESTNAME or PDEF 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="HEY THERE!") PDEF* PDEF = (DESTINATION="MYPRINTER", PRINTDISPOSITION=CLOSE)
