The INQUIRE_APP_CONTEXT call
The INQUIRE_APP_CONTEXT call returns to the exit program the application context data that is associated with the current application running the issuing task.
Restriction
Do not start exit programs that use the INQUIRE_APP_CONTEXT function until the second phase of the PLTPI. For more information about the PLTPI, see Writing initialization and shutdown programs.
INQUIRE_APP_CONTEXT
DFHMNIAX [CALL,]
[CLEAR,]
[IN,
FUNCTION(INQUIRE_APP_CONTEXT),
CONTEXT(INITIAL | CURRENT)]
[OUT,
[APPLNAME(name64),]
[PLATNAME(name64),]
[OPERNAME(name64),]
[MAJORVER(name4 | (Rn)),]
[MINORVER(name4 | (Rn)),]
[MICROVER(name4 | (Rn)),]
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
- APPLNAME(name64)
- Returns the 64-byte name of the application that is associated with the task.
- CONTEXT(INITIAL | CURRENT)
- The parameter CONTEXT(INITIAL | CURRENT) determines whether the application context values returned are for a tasks initial context or its current context. If the CONTEXT parameter is not specified, the default is to return the tasks current application context.
- MAJORVER(name4 | (Rn))
- Returns the major version number of the application that is associated
with the task.
- name4
- The name of a 4-byte field that contains the major version number as a binary value.
- (Rn)
- A register to receive the major version number.
- MICROVER(name4 | (Rn))
- Returns the micro version number of the application that is associated
with the task.
- name4
- The name of a 4-byte field that contains the micro version number as a binary value.
- (Rn)
- A register to receive the micro version number.
- MINORVER(name4 | (Rn))
- Returns the minor version number of the application that is associated
with the task.
- name4
- The name of a 4-byte field that contains the minor version number as a binary value.
- (Rn)
- A register to receive the minor version number.
- OPERNAME(name64)
- Returns the 64-byte name of the operation that is associated with the task.
- PLATNAME(name64)
- Returns the 64-byte name of the platform that is associated with the task.
RESPONSE and REASON values for INQUIRE_APP_CONTEXT
| RESPONSE | REASON |
|---|---|
| OK | None |
| EXCEPTION | APP_CONTEXT_UNAVAILABLE |
| DISASTER | None |
| INVALID | None |
| KERNERROR | None |
| PURGED | None |
For more information, see the explanation of RESPONSE and REASON in Making an XPI call.