DISASSOCIATE

Local Message Repository

Authorization

Privilege Class: A

Purpose

Use DISASSOCIATE to revoke all entry point and external symbol assignments associated with an exit point or local message repository using ASSOCIATE EXIT, MESSAGES, or MSGS commands or configuration file statements.

Operands

EXit exit

tells CP that you want to disassociate all entry points and external symbols from the specified exit point. The variable exit must be a hexadecimal number between X'0000' and X'FFFF'.

MESSages COMPonent compid LANGuage langid

MSGS COMPonent compid LANGuage langid

tells CP that you want to disassociate all entry points and external symbols from the specified local message repository.

The variable compid is a 1- to 3-character alphanumeric string. For example, the component ID for the system message repository (z/VM) is HCP.

The variable langid is a 1- to 5-character alphanumeric string. AMENG (American English) and UCENG (Uppercase English) are examples of two very common language IDs.

You can use generic language names to request a specific subset of languages. A generic language name is a 1- to 5-character string with asterisks (*) in place of 1 or more characters and percent signs (%) in place of exactly 1 character. For example:

… language %%en*

disassociates all languages that have EN as their third and fourth characters.

Usage Notes

When you use the DISASSOCIATE command for an exit point, CP does not change the status (enabled or disabled) of the exit point. If the exit point is enabled, it will remain enabled after your DISASSOCIATE command completes. If the exit point is disabled, it will remain disabled after your DISASSOCIATE command completes. Only the ASSOCIATE EXIT, DISABLE EXITS, and ENABLE EXITS commands (or configuration file statements) can change the status of the exit point.
To avoid unnecessary system processing, you should disable the exit point either before or after you issue the DISASSOCIATE command. If you do not disable the exit point, the effect is the same as having a single entry point name that did nothing except send back a return code of 0 (zero) to the mainline code.
After you revoke all entry point and external symbol assignments using the DISASSOCIATE command, you need to unload the customer-written CP routines using the CPXUNLOAD command (see CPXUNLOAD).
To assign entry points and external symbols to an exit point and to enable or disable that exit point, use the ASSOCIATE EXIT command (see ASSOCIATE EXIT).
To assign an external symbol to a local message repository, use the ASSOCIATE MESSAGES or MSGS command (see ASSOCIATE MESSAGES / MSGS).
After issuing DISASSOCIATE EXIT, CP erases the entry point names and external symbols from the CP exit block for that exit point, but CP does not erase the CP exit block itself. CP will not erase any CP exit blocks until the next IPL.
For more information about associating and disassociating entry points and external symbols, see z/VM: CP Exit Customization.

Responses

Response 1:

To empty the list of entry point names and external symbols for exit point X'7DF', enter the following series of commands:

query exit 7df
Exit  Status        Calls    Returns Seconds
07DF  Enabled           8          8 10.008833
      EPName     Attempts      Calls Seconds
      HCPSRC00          8          8 0.002598
      HCPSRCZZ          8          0 0.000000
      HCPSRC08          8          4 0.002833
      HCPSRC99          6          6 10.002668
Ready;
 
disassociate exit 7df
Ready;
 
query exit 7df
Ready;
Exit  Status        Calls    Returns Seconds
07DF  Enabled           8          8 10.008833

Response 2:

To empty the list of entry point names for the uppercase messages belonging to component AC$, enter the following series of commands:

query cplanglist associated
Language: AMENG  Component: AC$  EPName: AC$CSCT1
Language: UCENG  Component: AC$  EPName: AC$CSCT2
Ready;
 
disassociate msgs component ac$ language uceng
Ready;
 
query cplanglist associated
Language: AMENG  Component: AC$  EPName: AC$CSCT1
Ready;

Response 3:

To empty the list of entry point names for all the messages belonging to component AC$, enter the following series of commands:

query cplanglist associated
Language: AMENG  Component: AC$  EPName: AC$CSCT1
Language: UCENG  Component: AC$  EPName: AC$CSCT2
Ready;
 
disassociate msgs component ac$ language *eng
Ready;
 
query cplanglist associated
There are no associated message repositories
Ready;

Messages

HCP002E Invalid operand - operand
HCP003E Invalid option - command contains extra option(s) starting with option
HCP013E Conflicting option - option
HCP1014E A required option is missing - {COMPONENT | LANGUAGE | COMPONENT, LANGUAGE}
HCP2752E Exit number exit does not exist
HCP2752E Exit numbers do not exist
HCP2752E Exit numbers exit1-exit2 do not exist
HCP2754E Language xxxxx for Component yyy does not exist
HCP2778E {Language|Component} identifier id is not valid
HCP6704E Missing token at end of line
HCP6706E Invalid {string|CP Exit number} - {string|exit}