APLI gate, ESTABLISH_LANGUAGE function
The ESTABLISH_LANGUAGE function of the APLI gate is used to establish the language of a conventional compiled program.
Input Parameters
- DATA_LOCATION
- defines whether the program can handle only 24-bit addresses (data located below the 16MB line) can handle 31-bit addresses (data located above or below the 16MB line).
- Values for the parameter are:
- ANY
- BELOW
- DEFINED_LANGUAGE
- is the language defined for the program.
- Values for the parameter are:
- ASSEMBLER
- COBOL
- C370
- LE370
- NOT_DEFINED
- PLI
- ENTRY_POINT
- is the entry point address of the program.
- EXECUTION_KEY
- is a code indicating the execution key at the time the abend was issued, or at the time the operating system abend or program check occurred.
- Values for the parameter are:
- CICS
- USER
- LANGUAGE_BLOCK
- is a token identifying the current language block for the program.
- LOAD_POINT
- is the load point address of the program.
- PROGRAM
- is the 8-character name of the program whose language is to be determined
- PROGRAM_LENGTH
- is the length of the program.
- REQUEST_TYPE
- identifies the call of establish language. If the caller has a request type of link and establish language fails, then abend. Do not abend for a request type of load.
- Values for the parameter are:
- LINK
- LOAD
- THREADSAFE
- indicates whether whether the program is quasi-reentrant (and must execute on the QR TCB) or threadsafe (and can execute on the QR TCB or an OPEN TCB).
- Values for the parameter are:
- NO
- OPENAPI
- YES
- JVM_CLASS_PTR
- Optional Parameter
- is a token addressing the JVM class name length and value.
- JVM_DEBUG
- Optional Parameter
- An enumerated type indicating whether JVM debug is to be used
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- TRANSACTION_ABEND
- The following values are returned when RESPONSE is INVALID:
- INVALID_FUNCTION
- CICSVAR_THREADSAFE
- is the threadsafe value established for the program.
- Values for the parameter are:
- CICSVAR_NO
- CICSVAR_OPENAPI
- CICSVAR_YES
- NOT_DEFINED
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ABEND_CODE
- Optional Parameter
- is the four-character transaction abend code.
- LANGUAGE_ESTABLISHED
- Optional Parameter
- is the language established for the program.
- Values for the parameter are:
- ASSEMBLER
- ASSEMBLER_CICS
- COBOL
- COBOL2
- C370
- JVM
- LE370
- MVSLE370
- NOT_DEFINED
- PLI
- NEW_BLOCK
- Optional Parameter
- is a new token identifying the new language block for the program.
- RUNTIME_ENVIRONMENT
- Optional Parameter
- is the runtime environment established for the program.
- Values for the parameter are:
- JVM_RUNTIME
- LE370_RUNTIME
- NON_LE370_RUNTIME
- XPLINK_RUNTIME