PUNCH

The PUNCH utility retrieves the DMCL or database name table load module from the dictionary and writes it, in object module form, into the SYSPCH file.
idmscu19
The PUNCH utility retrieves the DMCL or database name table load module from the dictionary and writes it, in object module form, into the SYSPCH file.
This article describes the following information:
2
2
Authorization
To punch
You need this privilege
For
A DMCL
USE
The DMCL
A DBTABLE
USE
The DBTABLE
Syntax
  ►►─── PUNCH ──────────────────────────────────────────────────────────────────►  ►─┬─ DMCL LOAD MODULE dmcl-name ───────┬─────────────────────────────────────►◄    └─ DBTABLE LOAD MODULE dbtable-name ─┘  
Parameters
  • DMCL LOAD MODULE
    Directs the PUNCH utility to punch a DMCL load module from the dictionary.
  • dmcl-name
    Specifies the load module name of the DMCL to be punched.
  • DBTABLE LOAD MODULE
    Directs the PUNCH utility to punch a database name table load module from the dictionary.
  • dbtable-name
    Specifies the load module name of the DBTABLE to be punched.
Usage
How to submit the PUNCH statement
You submit the PUNCH statement only through the batch command facility.
JCL Considerations
When you submit a PUNCH statement through the batch command facility, the JCL to execute the facility must include statements to define:
  • The dictionary from which the load module is to be punched (local mode only)
  • The journal file(s) associated with the DMCL (local mode only) (these can be dummied out)
  • SYSPCH file.
For more information about the generic JCL used to execute the batch command facility, see the section for your operating system in this section.
Example
The following example directs the PUNCH utility to retrieve the IDMSDMCL DMCL definition from the dictionary and write it, in object module form, to a SYSPCH file.
punch dmcl load module idmsdmcl;
Output
The CA IDMS Batch Command Facility returns the following listing after successful completion of the PUNCH utility.
PUNCH DMCL LOAD MODULE IDMSDMCL; Status = 0
More Information
  • For more information about defining DMCL and DBTABLE modules, see the
    CA IDMS Database Administration Section
    .
  • For more information about deleting DMCL and DBTABLE load modules, see the
    CA IDMS Database Administration Section
    .