1.56 "TSO/E V2R5 Command Reference" IBM Library Server

1.56 OUTDES Command

Use the OUTDES command to create or reuse a dynamic output descriptor. An output descriptor defines output characteristics that will be referenced by a SYSOUT data set. OUTPUT JCL statements in the LOGON procedure can also be used to define output descriptors.

The OUTDES operand of the ALLOCATE command and the PRINTDS command allow you to specify a list of installation-defined output descriptors that were created by OUTPUT JCL statements in the LOGON procedure and by the OUTDES command. You can specify up to 128 output descriptors associated with a SYSOUT data set. See the "ALLOCATE Command" in topic 1.4 or the "PRINTDS Command" in topic 1.63 for more information.

Use operands on the OUTDES command to specify the following information:

° The name of the output descriptor to be created

° The NEW operand to create the output descriptor. The REUSE operand to replace an existing output descriptor.

° Output characteristics. The format and meanings of the output characteristics are described in MVS/ESA SP V5 JCL Reference, GC28-1479.

Note: You can use the OUTDES command in any supported JES2 environment. However, the OUTDES command in a JES3 environment requires that the JES3 component of MVS/ESA SP Version 4 be at Version 4 Release 2.1 or higher.

: For information about special considerations when using OUTDES, see : MVS/ESA SP V5 Auth. Assembler Services Guide, GC28-1467.

OUTDES Command Syntax

_NEW___ _NOBURST_ >>__OUTDES__output_descriptor_name__|_______|__|_________|_______________> |_REUSE_| |_BURST___|

>__ _______________________ __ _____________________________________ ____> | <_,________ | | <_,____________________ | |_CHARS(___charname_|_)_| |_ADDRESS(__ _delivery_address___ |_)_| |_'delivery_address'_|

>__ ___________________________________________ __ _________________ ____> |_BUILDING(_ _building_identification___ _)_| |_CKPTLINE(nnnnn)_| |_'building_identification'_|

>__ _______________________________________ _____________________________> |_COPIES(nnn_ ______________________ _)_| | <_,___________ | |_,(___group_value_|_)_|

>__ _________________________________________ ___________________________> |_DEPT(_ _department_identification___ _)_| |_'department_identification'_|

>__ ______________________ __ ___________________ _______________________> |_FORMDEF(member_name)_| |_FORMS(forms_name)_|

>__ ____________________________ __ _________________ ___________________> | |_GROUPID(output_group_name)_| | _1__ | | |_INDEX(_|_nn_|_)_|

>__ __________________ __ _____________ _________________________________> | | _1__ | |_LINECT(nnn)_| | |_LINDEX(_|_nn_|_)_|

>__ _______________________________ __ ______________________ ___________> |_MODIFY(module_name_ ______ _)_| |_PAGEDEF(member_name)_| |_,trc_|

>__ ______________________________ ______________________________________> |_NAME(_ _preferred_name___ _)_| |_'preferred_name'_|

>__ ________________________________ ____________________________________> | <_,________________ | |_NOTIFY(__ _user_id________ |_)_| |_'node.user_id'_|

>__ __________________________________________________ __________________> |_OUTDISP(normal_output_disp,abnormal_output_disp)_|

>__ __________________________________ __ ______________________ ________> |_PIMSG(_ _____________________ _)_| |_PRMODE(process_mode)_| | | _16__ | | |__ _YES_ _,_|_nnn_|__| |_NO__|

>__ ___________________________________ _________________________________> |_ROOM(_ _room_identification___ _)_| |_'room_identification'_|

>__ ______________________________________ __ ____________________ ______> |_TITLE(_ _description_of_output___ _)_| |_THRESHLD(nnnnnnnn)_| |_'description_of_output'_|

_NOTRC_ >__|_______|__ _______________ __ ______________________________ ________> |_TRC___| |_UCS(ucs_name)_| |_WRITER(external_writer_name)_|

>__ _________________________________ ___________________________________> | | <_,________________ | | |_USERLIB(__ _library_name___ |_)_| | |_'library_name'_|

>__ _____________________________ __ _______________________ ___________>< | | <_,___________ | |_OUTBIN(output_bin_id)_| |_USERDATA(__ _value_____ |_)_| |_'value n'_|

OUTDES Command Operands

output_descriptor_name specifies the name of the output descriptor to be created or reused. This operand is required. Specify 1 to 8 alphanumeric characters for the name. The first character must be alphabetic or one of the special characters (#, $, or @).

The OUTDES operand of the ALLOCATE, PRINTDS, and FREE commands refers to the output_descriptor_name specified.

NEW | REUSE

NEW specifies that a new output descriptor is to be created. If an output descriptor with the same name exists, the system ends your request unsuccessfully. NEW is the default.

REUSE specifies that if an output descriptor with the same name is found, the new definition replaces the old one. If an output descriptor with the same name does not exist, OUTDES creates a new output descriptor name.

BURST | NOBURST

BURST specifies that 3800 output is to be burst into separate sheets.

NOBURST specifies that the printed 3800 output is to be in continuous fanfold pages. NOBURST is the default.

CHARS(charname{,...}) specifies one or more font (character arrangement) tables for printing the SYSOUT data set on a 3800 printer. You can specify up to four table names. Specify 1 to 4 alphabetic, numeric, or special characters (#, $, or @) for the character name.

For more information about font (character arrangement) tables, see IBM 3800 Printing Subsystem Programmer's Guide.

ADDRESS(delivery_address) specifies the delivery address for system output (SYSOUT). This address prints on the separator pages. You can specify from 1 to 4 delivery addresses. For each delivery address, you can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

BUILDING(building_identification) specifies the building location associated with the SYSOUT. The building location prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

CKPTLINE(nnnnn) specifies the maximum number of lines contained in a logical page. Specify a value from 0 through 32767. The system uses this value either for JES checkpointing of printed output or for SNA transmission checkpoints. Use CKPTLINE in combination with the CKPTPAGE operand.

If you do not specify CKPTLINE, JES uses an installation default specified at initialization.

CKPTPAGE(nnnnn) specifies the maximum number of pages to be printed or transmitted before the next SYSOUT data set checkpoint occurs. Specify a value from 1 through 32767. This value represents the number of pages to be transmitted as a single SNA chain when data is transmitted to a SNA work station. Use CKPTPAGE in combination with the CKPTLINE operand.

If you do not specify CKPTPAGE, JES uses the installation default specified at initialization. The default may also indicate whether checkpoints are to be based on page count or time.

CKPTSEC(nnnnn) specifies the number of seconds that are to elapse between checkpoints of the SYSOUT data set that is printing. Specify a value from 1 through 32767.

If you do not specify CKPTSEC, JES uses the installation default specified at initialization. The default may also indicate whether checkpoints are to be based on page count or time.

CLASS(output_class) specifies the output class JES is to use for processing the specified SYSOUT data set. Valid output classes are characters A-Z, 0-9, or *. The CLASS parameter is equivalent to the CLASS parameter of the OUTPUT JCL statement. The attributes of each output class, including the default, are defined during JES initialization. Specifying an * requests the output class defined in the MSGCLASS parameter in the JCL for the LOGON procedure that is running. For information about the OUTPUT JCL statement, see MVS/ESA SP V5 JCL Reference, GC28-1479.

Note: When you allocate a SYSOUT data set, JES selects the output CLASS value using the following search order:

1. Output class specified on your user ID at logon 2. Output class specified on the ALLOCATE command 3. Output class specified on a referenced or default output descriptor.

COMPACT(compaction_table_name) specifies the name of the compaction table to be used when the data set is transmitted to a workstation. Specify a 1 to 8 alphanumeric character symbolic name. If you do not specify COMPACT, compaction is suppressed for the data set.

CONTROL({PROGRAM | SINGLE | DOUBLE | TRIPLE}) specifies the type of forms control to be used.

PROGRAM indicates that the carriage control character of each data record is to control line spacing on the form. PROGRAM is the default. The carriage control characters are given in MVS/DFP Managing Non-VSAM Data Sets.

SINGLE indicates forced single spacing.

DOUBLE indicates forced double spacing.

TRIPLE indicates forced triple spacing.

| COPIES(nnn,(group_value)) specifies the number of copies to be printed for the data set. The number of copies, nnn, can range from 1 to 255, subject to an installation limit. The default is 1.

If you use COPIES on a referenced FORMDEF operand (described later), the system ignores the COPIES value.

If you specify group values, the system ignores the individual value, nnn, for the 3800 printer. The group values describe how the printed copies are to be grouped (3800 printer only). Each group value specifies the number of copies of each page that are to be grouped together. You can specify up to 8 group values. For example, a group value of 3 causes the first page of a data set to be printed three times before printing is started for the second page, which might also be printed three times, and so forth.

DATACK({BLKCHAR | BLKPOS | BLOCK | UNBLOCK}) specifies whether "print positioning" and "invalid character" data check errors are to be blocked or unblocked for printers accessing through the functional subsystem Print Services Facility (PSF).

BLKCHAR specifies character errors that are not valid are to be blocked. The errors are not reported to PSF. Print positioning errors are reported normally.

BLKPOS specifies print positioning errors are to be blocked, and not reported to PSF.

BLOCK specifies neither print positioning errors nor character errors that are not valid are reported to PSF.

UNBLOCK specifies both print positioning errors and character errors that are not valid are reported to PSF.

If you do not specify DATACK, the DATACK specification from the PSF PRINTDEV statement is used. If it is not specified in the PRINTDEV statement, the default is BLOCK.

DEFAULT | NODEFAULT

DEFAULT specifies that the output descriptor defined by this OUTDES command is the default output descriptor. SYSOUT data sets that do not explicitly refer to an output descriptor use the output characteristics specified in this OUTDES command.

NODEFAULT specifies that an ALLOCATE or PRINTDS command must explicitly reference the output descriptor to use the defined output characteristics specified in this OUTDES command.

Note: When a default output descriptor is defined with a CLASS value, TSO/E commands such as ALLOCATE, PRINTDS, and SMCOPY may use their own default output class instead.

DEPT(department_identification) specifies the department identification associated with the SYSOUT. This department identification prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

| DEST(destination | destination.user_id) specifies the destination of a remote work station or a user at a specific remote work station to which the output is routed for processing. You can specify from 1 to 8 characters for either destination or user_id.

For information about what you can specify for destination or destination.user_id, see MVS/ESA SP V5 JCL Reference, GC28-1479.

DPAGELBL | NODPAGELBL specify whether the system is to print a security-related character string on each page of output.

DPAGELBL specifies that the system is to print the character string. The character string is associated with a security label (usually the security label of the user's current session). Your installation determines the character string used.

NODPAGELBL specifies that the character string is to be suppressed. You must have the appropriate RACF access authority to override page labeling. If you need to override DPAGELBL but are unable to, check your installation security procedures or see your RACF security administrator.

FCB(fcb_name) specifies the name of the forms control buffer (FCB) or image to be used for the 3211, 3203-5, or 3800 printers. The name of the FCB is a 1 to 4 alphanumeric character string consisting of the last 1 to 4 characters of the following:

° FCB2xxxx member for the 3211 or 3203-5 printer or printers supported by System Network Architecture (SNA)

° FCB3xxxx member for the 3800 printer.

For more information about the forms control buffer, see:

° MVS/DFP Managing Non-VSAM Data Sets ° IBM 3800 Printing Subsystem Programmer's Guide.

| FLASH(overlay_name[,copies]) specifies the name of a forms overlay, which can be used by the 3800 Printing Subsystem. The overlay is "flashed" on a form or other printed information over each page of output. The forms overlay_name | must be 1 to 4 alphabetic, numeric, or special characters (#, $, or | @). Optionally, you can specify the number of copies on which the | overlay is to be printed. The count can range from 0 to 255. To | flash no copies, specify a count of zero.

FORMDEF(member_name) specifies the member name of a partitioned data set containing information that the Advanced Function Printer (AFP* 3800-3 or 3800-8) uses to print a data set. The member can contain the following information:

° The overlays that are to be invoked during output processing ° The location on the page where the overlays are to be placed ° The suppressions that can be activated for specified page formats.

The member name contains a maximum of 6 characters, of which the first 2 are predefined by your installation. For the last 4 characters, specify alphabetic, numeric, or special characters (#, $, or @).

FORMS(forms_name) specifies the name of the form on which the output is to be printed. Specify 1 to 8 alphabetic, numeric, or special characters (#, $, or @) for the forms name.

If you do not specify FORMS, JES uses the installation default specified at initialization.

GROUPID(output_group_name) specifies the name to be used by JES to identify which of a job's SYSOUT data sets are to form an output group. The output group name consists of 1 to 8 alphanumeric characters and is selected by the system programmer to define an output group for the job.

INDEX(nn) specifies a value indicating the data set indexing print offset (to the right) for the 3211 printer with the indexing feature. The width of the print line is reduced by the value of INDEX. Specify a value from 1 through 31. The value 1 indicates flush left. The values 2 through 31 indent the print line by nn-1 positions.

The default is 1, which indicates flush left.

LINDEX(nn) specifies a value indicating the data set indexing print offset (to the left) for the 3211 printer with the indexing feature. The width of the print line is reduced by the value of LINDEX. Specify a value from 1 through 31. The value 1 indicates flush right. The values 2 through 31 move the right margin over by nn-1 positions.

The default is 1, which indicates flush right. LINDEX is ignored on printers other than the 3211 printer.

LINECT(nnn) specifies the number of lines that are to be printed before overflow processing. Specify a value from 0 through 255. If you specify zero, no overflow processing is done.

If you do not specify LINECT, JES obtains the value from one of the following:

1. The LINECT field of the accounting information parameter on the JCL JOB statement.

2. The installation default specified at JES initialization.

MODIFY(module_name[,trc]) specifies the name of a copy modification module, which is loaded into the 3800 printing subsystem. This module contains predefined data such as legends, column headings, or blanks. The module specifies where and on which copies the data is to be printed. TSO/E defines and stores the module in the SYS1.IMAGELIB system data set. Specify 1 to 4 alphabetic, numeric, or special characters (#, $, or @) for the module_name.

The table reference character (TRC) corresponds to the character set(s) specified on the CHARS operand. Values are 1 to 4 alphabetic, numeric, or special characters (#, $, or @).

NAME(preferred_name) specifies the preferred name to be associated with the SYSOUT. The name prints on the separator pages to identify the owner of the SYSOUT. You can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

NOTIFY(user_id,node.user_id) specifies the user ID that is to receive a print completion message. The message identifies the output that has completed printing and indicates whether the printing was successful. You can specify 1 to 4 user IDs to which to send the print completion message.

A JES2 system issues the print complete message when all the SYSOUT data sets for an output group have printed. An output group consists of the SYSOUT data sets printed between the output header page and the output trailer page of a job. A JES3 system issues the print complete message when the SYSOUT data sets for the same printer and the same job have printed.

If you do not specify node, NOTIFY defaults to the node where the job was submitted.

OUTDISP(normal_output_disp,abnormal_output_disp) specifies the disposition(s) for the output data set for normal and abnormal program terminations.

normal_output_disp is the disposition for the output data set when the job completes normally. The default for this parameter is WRITE, unless the installation has chosen a different default disposition.

abnormal_output_disp is the disposition for the output data set when the job completes abnormally. This parameter defaults to the disposition specified in normal-output-disposition, if one was specified. Otherwise, it defaults to the installation default (WRITE).

You can specify one of the following for either or both of the positional parameters:

WRITE specifies that the output file is to be deleted immediately after processing.

HOLD specifies that the output data is to be held until released by the TSO/E user or operator. Releasing the output changes its disposition to WRITE.

KEEP specifies that the output file is to be processed. After processing, the data set disposition changes to LEAVE.

LEAVE specifies that the output data is to be held until released by the TSO/E user or operator. Releasing the output changes its disposition to KEEP.

PURGE specifies that the output data set should be deleted before processing.

PAGEDEF(member_name) specifies the member of a partitioned data set containing information that the Advanced Function Printer (AFP) uses to print the data set. The member can contain the following information:

° Logical page size and width ° Fonts ° Page segments ° Multiple page types or formats ° Lines within a page; for example, line origin, carriage controls, and spacing ° Multiple logical pages on a physical page.

PIMSG[(YES,nnn) | (NO,nnn)] specifies whether messages are to be printed. Values are 0 through 999. The value specifies that the system is to cancel the printing of the current data set after the specified number of errors have been either:

° Detected by the functional subsystem (FSS), or ° Reported to FSS by the printer.

PIMSG(YES) specifies that messages generated by FSS are to be printed. PIMSG(YES,16) is the default.

PIMSG(NO) specifies that messages are to be suppressed.

If you specify nnn as zero, the system does not cancel the printing of the current data set.

PRMODE(process_mode) specifies the process mode to be used to schedule output data sets either to output devices running under a functional subsystem (FSS) or to an output device managed by JES. For a list of valid process modes, contact your system programmer. If you do not specify PRMODE, JES might determine the process mode based on the content of the data. Specify 1 to 8 alphabetic or numeric characters for the process mode.

Use PRMODE to indicate the type of processing you want for a data set. You can use it to direct JES scheduling of this data set to a particular output FSS or JES writer. You can also use PRMODE to request specific processing of a Network Job Entry (NJE) transmitted data set at the destination node without knowing the device name or a SYSOUT class.

PRTY(nnn) specifies the initial selection priority for the data set. Specify a value from 0 through 255, where 0 is the lowest output processing priority and 255 is the highest output processing priority.

ROOM(room_identification) specifies the room identification to be associated with the output data set. This room identification prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

SYSAREA | NOSYSAREA

SYSAREA specifies that the system printable area is to be reserved for printing a character string associated with a security label. SYSAREA is the default.

NOSYSAREA specifies that you want to print on the entire page of output (including the system printable area) for the current printing. Here, the system area is not reserved for printing a security character string. You must have the appropriate RACF access authority to override page labeling. If you need to override the system area but are unable to, check your installation security procedures or see your RACF security administrator.

TITLE(description_of_output) specifies the report title to be associated with the output file. This title prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. Refer to "Coding Rules" for the valid characters allowed with and without quotes.

TRC | NOTRC

TRC specifies whether the data records contain table reference character (TRC) codes. The codes identify the font to be used to print each record.

A TRC code immediately follows the carriage control character, if any. Its value corresponds to either one of the four fonts specified by CHARS or one of the fonts in the PAGEDEF font list. PAGEDEF allows more than four fonts to be specified.

NOTRC specifies that the data set does not contain TRC codes. NOTRC is the default.

UCS(universal_character_set_name) specifies the name for the universal character set. Specify up to 4 alphabetic, numeric, or special characters (#, $, or @). If you process the print data set through PSF and do not specify CHARS, the system uses the UCS as the font name.

For more information about universal character sets, see MVS/DFP Managing Non-VSAM Data Sets.

WRITER(external_writer_name) specifies the member name of an installation-written program in the system library that is to write the SYSOUT data set, instead of JES2 or JES3. If you specify the external writer name, the output data set is written under the control of that external writer rather than the control of JES2 or JES3. The writer name can contain 1 to 8 alphabetic, numeric, or special characters (#, $, or @).

For more information about external writers, see MVS/ESA SP V5 Using the Subsystem Interface, SC28-1502.

USERDATA(value) specifies the installation-defined values for the installation's prescribed processing. If your installation has defined further keywords through installation exits, that optional processing can be requested on the output descriptor with this keyword. Refer to your installation's definition for the intended use of this keyword operand.

You can code up to 16 installation-defined values for this keyword as previously specified by your installation. Each value can be 1 to 60 EBCDIC text characters. Apostrophes around each value are required if the string contains a blank, comma, tab, or semicolon; apostrophes are optional for all other EBCDIC characters. However, if the string contains an apostrophe, code two apostrophes and enclose the entire string in single apostrophes such as USERDATA('USERKEY1=User''s value'). Null positions such as USERDATA(value_1,,value_3) or USERDATA(,value_2,value_3) are not allowed.

| USERLIB(library_name {,libray_name ...}) specifies the dataset name(s) of the libraries that contain the Advanced Function Printer (AFP) resources that the Print Services Facility (PSF) uses when processing the SYSOUT data set. The AFP resources that specify how the PSF is to print the SYSOUT data set are:

° Fonts ° Page Segments ° Overlays ° Pagedefs ° Formdefs

Note: This parameter is not supported for PSF/MVS direct-attached printing.

You can use user libraries to maintain secure resources (such as signatures in private data sets), keep resources that are being tested in a private data set during the test period, or personalize and maintain your own library.

PSF searches for resources first in the resource libraries specified by USERLIB, then in the system-defined resources.

| library_name specifies the data set name of a library containing the Advanced Function Printer (AFP) resources. The specified library can contain any AFP resources.

The data set name must follow the rules for MVS data set names. See MVS/ESA SP V5 JCL Reference, GC28-1479, for the rules regarding data set names. If the application supports the specification of unqualified data set names and you specify the USERLIB parameter without quotes, the specified data set name is concatenated to the system-defined high-level qualifier.

If you do not specify the USERLIB parameter, only the system and installation print resources are available for use.

A library is a partitioned data set (PDS). Member names are the same as the requested resource. When you create a member, the member name should be unique to all libraries in the search concatenation.

When you use the USERLIB keyword:

° You must have read access (for example, via RACF) to libraries specified by USERLIB.

° Libraries must be cataloged in a catalog that is available to PSF/MVS.

° Libraries must be accessible to PSF while processing the SYSOUT data set.

° Library data sets are dynamically unallocated after PSF has processed the SYSOUT data set.

Refer to PSF/MVS Application Programming Guide for more information on the USERLIB keyword.

| OUTBIN(output_bin_id) (4) | specifies the media destination for the SYSOUT data set to be | processed by JES2 or by JES3. output_bin_id specifies the identifier | of the printer output bin on the IBM family of Advanced Function | Printers supporting multiple output bins.

| The valid range for output_bin_id is 1 to 65,535. No default value is | provided.

| If no OUTBIN operand is given, the Print Services Facility (PSF) will | stack the output in the default output bin.

| If no output_bin_id value is provided with the OUTBIN operand (for | example, OUTDES OUT1 OUTBIN is entered), the system will prompt you | for the required value by issuing the following message:

| ENTER PRINTER OUTPUT BIN ID

| If a value for output_bin_id is specified that is not one of the | supported ones, PSF will stack the output in the printer's default | output bin and issue a message indicating that the requested bin is | not available.

| For more information on multiple media destinations and OUTBIN | processing see PSF/MVS Application Programming Guide.

Coding Rules

° The following characters are valid in strings with quotes:

- Any valid EBCDIC character

- Two consecutive single quotes to specify a single quote in a quoted string

- Enclose values that contain blanks in quotes.

- A semicolon (;) is allowed within a quoted string unless you are issuing the command under ISPF or PCF. When under ISPF or PCF, the semicolon or the alternate character your installation may have specified as the command delimiter, still functions as a command delimiter and may cause a syntax error.

° The following characters are valid in strings without quotes:

- Alphanumeric - Special Characters: - @ is represented as X'7C' - $ is represented as X'5B' - # is represented as X'7B'.

Character sets that use hexadecimal representations other than those listed above may cause an error.

OUTDES Command Return Codes

__________________________________________________________________________ | Figure 1-29. OUTDES Command Return Codes | |_______________ __________________________________________________________| | 0 | Processing successful. | |_______________|__________________________________________________________| | 12 | The installation exit requested termination. | |_______________|__________________________________________________________| | 16 | Processing unsuccessful. | |_______________|__________________________________________________________|

OUTDES Command Examples

Example 1

This example shows how the OUTDES, ALLOCATE, and FREE commands work together to define, reference, and free the dynamic output descriptor.

Operation: Specify the OUTDES command to define the dynamic output descriptor.

Known:

° Name of the new output descriptor: MULTCOPY ° Number of copies: 3 ° Pages are to be burst ° Output class: I

outdes multcopy copies(3) burst class(i) new

Operation: Specify the ALLOCATE command to reference the dynamic output descriptor.

Known:

° Name of the file: SYSPRINT ° Name of the output descriptor: MULTCOPY

allocate file(sysprint) new outdes(multcopy)

Operation: Specify the FREE command to free the file and the dynamic output descriptor.

Known:

° Name of the file: SYSPRINT ° Name of the output descriptor: MULTCOPY

free file(sysprint) outdes(multcopy)

Example 2

Operation: Specify the OUTDES command to define the dynamic output descriptor.

Known:

° Name of the output descriptor: ONECOPY ° Number of copies: 1 ° No security labels are to be printed on pages. ° Pages are to be burst.

outdes onecopy copies(1) nodpagelbl burst new

Example 3

Operation: Specify the OUTDES command to reuse the dynamic output descriptor.

Known:

° Name of the output descriptor: MULTCOPY ° Number of copies: 3 ° The output will fill the whole page including the system printable area. ° Replace the existing MULTCOPY output descriptor.

outdes multcopy copies(3) nosysarea reuse

Example 4

Operation: Specify the OUTDES command to print routing information on the separator pages.

Known:

° Name of the new output descriptor: NEWDEST ° Address for delivery is: IBM Corporation P.O. Box 950 Poughkeepsie, NY 12602 ° Building to use for distribution: 510 ° Data set disposition if the job completes normally: KEEP ° Data set disposition if the job completes abnormally: PURGE ° DEPT to be placed on the report: Payroll ° NAME to be placed on the report: J. Plant ° Room to be placed on the report: Conference Room 'A' ° Title to be placed on the report: OVER-TIME

outdes newdest address('IBM Corporation','P.O. Box 950','Poughkeepsie, NY, 12602') building(510) outdisp(keep,purge) dept(Payroll) name('J. Plant') room('Conference Room ''A''') title(OVER-TIME)

Example 5

Operation: Specify the OUTDES command with a default normal disposition and a specified abnormal disposition.

Known:

° Name of the new output descriptor: DESTA ° Default data set disposition if the job completes normally: WRITE ° Data set disposition if the job completes abnormally: PURGE

outdes desta outdisp(,purge)

Example 6

Operation: Specify the OUTDES command with a specified normal disposition and default abnormal disposition.

Known:

° Name of the new output descriptor: DESTB ° Data set disposition if the job completes normally: PURGE ° Default data set disposition if the job completes abnormally: PURGE

outdes destb outdisp(purge)

Example 7

Operation: Specify the OUTDES command with specified normal and abnormal dispositions.

Known:

° Name of the new output descriptor: DESTC ° Data set disposition if the job completes normally: PURGE ° Data set disposition if the job completes abnormally: HOLD

outdes destc outdisp(purge,hold)

Example 8

Operation: Specify the OUTDES command to define a user library for PSF resources.

Known:

° Name of the new output descriptor: NEWDESC ° Page definition name to be used: STNDRD ° Libraries to be searched: USER.PRIVATE.RESOURCE and then GROUP.PRIVATE.RESOURCE

outdes newdesc new pagedef(stndrd) userlib('user.private.resource','group.private.resource')

| (4) The OUTBIN operand on the TSO/E OUTDES command is the | equivalent to the OUTBIN keyword of the OUTPUT JCL statement, | introduced in support of MVS/PSF SP 2.2. Beside this, it | requires MVS SP 4.2.0 or higher, JES 2 SP 4.2.0 or higher, or | JES 3 SP 4.2.1 or higher.

1.56 OUTDES Command

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.