ADD Subcommand

The following topics are covered in this section:
capan146
The following topics are covered in this section:
The ADD subcommand adds TSO sequential data sets or PDS members to the
Panvalet
library. Required information includes the
Panvalet
member name and the language format. Data sets added to the library with the formats ALC, COBOL, PL/1, FORTRAN, JCL, or any ZTYPEs that mimic the mentioned languages are normally stored with
Panvalet
internal format, retaining the sequence NUMBER field. Other language types are stored with
Panvalet
internal format.
Syntax
PAN ADD              NAME              {FORMAT(  )}                                        [DATASET(  )]                                        [DDNAME(  )]                                        [USER(  )]                                        [NOFORMAT]                                        [PANVALET]                                        [TSO     ]                                        [DELETE]                                        [KEEP  ]                                        [CONTROL(  )]
Parameters
  • PAN ADD
    The minimum abbreviation is PAN A.
  • Name
    The member name of the
    Panvalet
    member name you want to add.
    When you initially enter a member into the library, assign the member a unique name. This name is used to reference the member for retrievals. The name can consist of ten alphanumeric or special characters in any order or combination
    (A-Z, 0-9, #, $, or @).
    See Keyword Summary for additional information.
  • FORMAT( )
    Required. Specifies the library formats. The
    Panvalet
    name that you add with certain TSO formats is stored according to one of the following
    Panvalet
    formats:
 
TSO Format
Panvalet
Format
PLI, PLIF, IPLI, PL/I, or PL/1
PL/I
CNTL
JCL
TEXT, BASIC, CLIST or GOFORT
OTHER
For a complete list of available formats, see Keyword Summary (default naming conventions).
The minimum abbreviation is F.
  • DATASET( )
    Optional. Specifies the input data set name. The minimum abbreviation is D.
  • DDNAME( )
    Optional. Specifies an alternate ddname for the
    Panvalet
    library. The minimum abbreviation is DD.
  • USER( )
    Optional. Specifies a user code for the library member. The minimum abbreviation is U.
  • NOFORMAT
    Optional. Requests that neither special TSO handling nor
    Panvalet
    handling is performed, but that each entire statement is stored. The minimum abbreviation is N.
  • PANVALET*
    Optional. Requests that special TSO handling is not performed, but that each statement is stored according to the
    Panvalet
    internal format. The minimum abbreviation is P.
  • TSO*
    Optional. Requests that each statement is stored with TSO internal format. The minimum abbreviation is T.
  • DELETE**
    Optional. Requests that the input data set is deleted after a successful add. The minimum abbreviation is DE.
  • KEEP**
    Optional. Requests that the input data set is kept after a successful add. The minimum abbreviation is K.
  • CONTROL( )
    Optional. Specifies a library control value needed to successfully perform the add if the subcommand is suppressed. The minimum abbreviation is CON.
    * The installation default for internal formatting can be
    Panvalet
    or TSO. You can use the opposite parameter to override the default at execution time.
    ** The installation default for disposition of the input data set can be KEEP or DELETE. You can use the opposite parameter to override the default at execution time.
Examples
This section provides examples of how to code the ADD command:
  • Specify the following to add a TSO data set with a data set name of userid.PAYROLL5.ASM to the
    Panvalet
    library under the name of PAYROLL5, using BAL TSO internal format. The input data set is deleted if the add is successful.
    PAN A PAYROLL5 F(BAL) TSO DE
If TSO is the installation default parameter, specify the following to add a TSO data set with a data set name of userid.V2DATERPT.COBOL to the
Panvalet
library under the name of V3DATERPT. Uses a COBOL TSO internal format and assigns a user code of 32 to the new member.
PAN A V3DATERPT F(COBOL) DA(V2DATERPT) U(32)
  • Specify the following to add a TSO data set with a data set name of SFTWRE.JCLTEST.CNTL to the
    Panvalet
    library under the name of TSTNEWJCL, using a JCL
    Panvalet
    internal format.
    PAN AD TSTNEWJCL DA('SFTWRE.JCLTEST.CNTL') F(JCL) PAN