/UNLOCK PGM command

The /UNLOCK PGM command specifies the application program to be unlocked.

This command can be issued by APPC and OTMA clients.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /UNLOCK PGM command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/UNLOCK X X X
PGM X X X

Syntax

Read syntax diagramSkip visual syntax diagram
                     .-------------------------.   
                     V                         |   
>>-+-/UNLOCK-+--PGM----pgmname--+------------+-+---------------><
   '-/UNL----'                  '-(password)-'     

Usage notes

The /UNLOCK PGM command is valid only if entered from the master terminal, the system console, a TCO script, or from an AOI application program.

Equivalent IMS type-2 commands

The following table shows variations of the /UNLOCK PGM command and the IMS™ type-2 commands that perform similar functions.

Table 2. Type-2 equivalents for the /UNLOCK PGM command
Task /UNLOCK PGM command Similar IMS type-2 command
Unlocks a program. /UNLOCK PGM pgmname UPDATE PGM NAME(pgmname) SET(LOCK(OFF))

Examples

The following is an example of the /UNLOCK PGM command:

Entry ET:
  /UNLOCK PGM APPLETRE
Response ET:
  DFS058I  UNLOCK COMMAND COMPLETED

Explanation: Application program APPLETRE is unlocked and can be executed.