6.6 Card Punch Devices

6.6.1 Function

The card punch statement defines a card punch device to the Hercules configuration. The argument
specifies the name of the file to which the punched output will be written. Additional arguments may be
specified after the filename.

6.6.2 Syntax

Descriptive

filename

Diagram

Êʬ¬¬ ¬¬¬ ¬¬¬ filename ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

6.6.3 Parameter

devaddr

This is the device address.

devtype

This is the device type. A valid card punch type is 3525.

filename

The name (and optionally the path) of the card punch file.

ASCII

ASCII specifies that the file will be written as variable length lines of ASCII charac-
ters, delimited by line feeds or carriage return line feed sequences. Trailing blanks
are removed from each line. If the ASCII argument is not specified, the file is written
as fixed length 80-byte EBCDIC records with no line-end delimiters.

CRLF

This optional parameter specifies that carriage return line feed sequences are writ-
ten at the end of each line. If the CRLF argument is not specified, line feeds are
only written at the end of each line.

NOCLEAR

This argument specifies that the output file will not be cleared to zero bytes when it
is opened. If NOCLEAR is not specified, then any previous content of the file is de-
stroyed when the file is opened for output.

6.6.4 Examples

Example 1:

Define a 3525 card punch device on device address 000D. The punched output has to be written to the
file "D/PCH/PCH1.TXT" as variable length lines of ASCII records delimited by carriage return line feed
sequences. Any existing output in the file has to be kept when the file is opened for output.

000D 3525 D:/PCH/PCH1.TXT ASCII CRLF NOCLEAR

Example 2:

Define a 3525 card punch device on device address 000D. The punched output has to be written to the
file "D/PCH/PCH2.TXT" as fixed length 80-byte EBCDIC records with no line-end delimiters. Any existing
output in the file will be destroyed when the file is opened for output.

000D 3525 D:/PCH/PCH2.TXT