PUNCH                                                     CMS Transient command

Use the PUNCH command to punch a CMS disk file to your virtual punch.  The
format of the PUNCH command is:
+----------+------------------------------------------------------------------+
| PUnch    | fn ft [* fm] [([Header|NOHeader] [Member *|membername][)]]       |
+----------+------------------------------------------------------------------+
where:

fn       is the filename of the file to be punched.  This field must be
         specified.

ft       is the filetype of the file to be punched.  This field must be
         specified.

fm       is the filemode of the file to be punched.  If you specify it as an
         asterisk (*), the standard order of search is followed and the first
         file found with the specified filename and filetype is punched.  If fm
         is not specified, your A-disk and its extensions are searched.

Options:

Header | NOHeader
         inserts a control card in front of the punched output.  This control
         card indicates the filename and filetype for a subsequent READCARD
         command to restore the file to a disk.  The control card format is
         shown below.  NOHeader does not punch a header control card.

MEMber * | membername
         punches members of MACLIBs or TXTLIBs.  If an asterisk (*) is entered,
         all individual members of that macro or text library are punched.  If
         membername is specified, only that member is punched.  If the filetype
         is MACLIB and the MEMBER membername option is specified, the header
         contains MEMBER as the filetype.  If the filetype is TXTLIB and the
         MEMBER membername option is specified, the header card contains TEXT
         as the filetype.

Header Control Card:
   Column   Field Width   Contents   Meaning
   1        1             :          Identifies card as a control card.
   2-5      4             READ       Identifies card as a READ control card.
   6-7      2             blank
   8-15     8             fname      Filename of file punched.
   16       1             blank
   17-24    8             ftype      Filetype of file punched.
   25       1             blank
   26-27    2             fmode      Filemode of file punched.
   28       1             blank
   29-34    6             volid      Disk label from which file was read.
   35       1             blank
   36-43    8             mm/dd/yy   Date file was last written.
   44-45    2             blank
   46-50    5             hh:mm      Time of day file was written.
   51-80    30            blank


Usage notes:

1.  You can punch fixed- or variable-length records with the PUNCH command, as
    long as no record exceeds 80 characters.  Records with less than 80
    characters are right-padded with blanks.  Records longer than 80 characters
    are rejected.  PUNCH changes variable-length record files to fixed-length
    80-byte record files.

2.  If you punch a MACLIB or TXTLIB file specifying the MEMBER * option, a READ
    control card is placed in front of each library member.  If you punch a
    library without specifying the MEMBER * option, only one READ control card
    is placed at the front of the deck.

3.  One spool punch file is produced for each PUNCH command; for example:
       punch compute assemble (noh
    punches the file COMPUTE ASSEMBLE, without inserting a header card.  To
    transmit multiple CMS files as a single punch file, use the CP SPOOL
    command to spool the punch with the CONT option.