USE command: Directing output

From m204wiki
Revision as of 21:15, 16 January 2018 by JAL (talk | contribs) (add "See also" section)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

USE command capabilities

The capabilities available through USE depend upon the operating system under which Model 204 is running. The capabilities of the USE command are:

  • z/OS users can dynamically create printer and punch output and can submit jobs.

  • z/VM users running under z/VM or under a guest operating system can dynamically create both print and punch files using the z/VM spooling system.

  • z/VSE users can dynamically create printer and punch output and can submit jobs using POWER.

  • CICS users can print output on CICS printers.

  • All users can write output to sequential data sets.

  • USE support is at the command level. See RESET COMMAND: Control USE data set support for details.

Forms of the USE command

Information on each form of the USE command is provided in the sections that follow.

The way in which Model 204 handles the name specified in a USE command is determined in a hierarchical manner.

If the command takes the form:

USE name

where name does not begin with the prefix OUT, Model 204 searches in the following order:

  1. Device specified by a DEFINE PRINTER command

  2. Device specified by a DEFINE PUNCH command

If the command takes the form:

USE OUTxxxxx

where OUTxxxxx is a data set or device name beginning with the prefix OUT, then Model 204 searches in the following order:

  1. Data set specified by a DEFINE DATASET command

  2. Existing data set

  3. Device specified by a DEFINE PRINTER command

  4. Device specified by a DEFINE PUNCH command

You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.

USE command output

The format of the USE command's output is affected by the settings of these user parameters:

Parameter

Meaning

UDDCCC Continuation character column on the alternate output
UDDLPP Number of lines per page on the alternate output
UDDRFM Record format for the alternate output
MUDD Maximum number of lines on the alternate output

When a USE command is executed, Model 204 opens the specified sequential device. It remains open until a command, such as BEGIN, MORE, or DISPLAY, causes data to be written on it. If other commands are issued before the command that produces output, the data set remains open until an output command is issued and the output is completed.

Commands with the USE=RESPECT option close the USE output area and generate the following message whether or not output is generated:

M204.1327: NUMBER OF U DD LINES OUTPUT=n

A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, Model 204 automatically closes the first data set before opening the second.

If a User Language request ends with an END USE statement, the USE data set is left open after the request has been completed, allowing output from another request to be added to the original output. The output page number is not reset. If the USE keyword is not specified in the END statement, the USE command applies only to the first request or DISPLAY command following the USE command.

The USE command must be repeated before any other request whose output is to appear in the data set.

If an I/O error is encountered in the USE data set, the request being run is canceled.

If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.

See also