Table 2 summarizes the external subroutine interfaces provided by the autoinstall terminal model manager. It shows the subroutine call formats, the level-1 trace point IDs of the modules providing the functions for these formats, and the functions provided.
Format | Trace | Function |
---|---|---|
AIIN |
AP 0F10 AP 0F11 |
START_INIT COMPLETE_INIT |
AIIQ |
AP 0F18 AP 0F19 |
LOCATE_TERM_MODEL UNLOCK_TERM_MODEL INQUIRE_TERM_MODEL START_BROWSE GET_NEXT END_BROWSE |
AITM |
AP 0F08 AP 0F09 |
ADD_REPL_TERM_MODEL DELETE_TERM_MODEL |
The START_INIT function of the AIIN format is used to attach a CICS® task to perform initialization of the AITM manager.
None.
OK|DISASTER|KERNERROR
The COMPLETE_INIT function of the AIIN format is used to wait for the initialization task attached by the START_INIT function to complete processing.
None.
OK|DISASTER|KERNERROR
The LOCATE_TERM_MODEL function of the AIIQ format is used to obtain the attributes of a named autoinstall terminal model, and obtain a read lock on that entry in the AITM table in virtual storage.
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER | TM_LOCATE_FAILED |
EXCEPTION | TERM_MODEL_NOT_FOUND |
The UNLOCK_TERM_MODEL function of the AIIQ format is used to release a read lock on a previously located entry from the AITM table in virtual storage.
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER | TM_UNLOCK_FAILED |
EXCEPTION | TERM_MODEL_NOT_FOUND |
The INQUIRE_TERM_MODEL function of the AIIQ format is used to obtain the attributes of a named autoinstall terminal model. (No read lock is retained.)
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER |
TM_LOCATE_FAILED TM_UNLOCK_FAILED |
EXCEPTION | TERM_MODEL_NOT_FOUND |
The START_BROWSE function of the AIIQ format is used to initiate a browse of the AITM table. The browse starts at the beginning of the table.
None.
OK|DISASTER|KERNERROR|PURGED
START_BROWSE_FAILED
The GET_NEXT function of the AIIQ format is used to obtain the name and attributes of the next autoinstall terminal model in the AITM table for the specified browse session.
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER |
TM_GET_NEXT_FAILED TM_UNLOCK_FAILED |
EXCEPTION | END_OF_MODELS |
The END_BROWSE function of the AIIQ format is used to terminate a browse of the AITM table.
OK|KERNERROR
The ADD_REPL_TERM_MODEL function of the AITM format is used to add or update an entry in the AITM table in virtual storage, and record the entry on the CICS catalog.
COLD_START|WARM_START|ONLINE
where
ONLINE means during execution.
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER |
NOT_INITIALISED ADD_REPL_FAILED |
EXCEPTION | TERM_MODEL_IN_USE |
The DELETE_TERM_MODEL function of the AITM format is used to remove an entry from the AITM table in virtual storage and the CICS catalog.
COLD_START|WARM_START|ONLINE
where
ONLINE means during execution.
OK|EXCEPTION|DISASTER|KERNERROR
RESPONSE | Possible REASON values |
---|---|
DISASTER |
NOT_INITIALISED DELETE_FAILED |
EXCEPTION |
TERM_MODEL_IN_USE TERM_MODEL_NOT_FOUND |