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


dfhs3_APLIestablish_language.html | Timestamp icon Last updated: Monday, 5 June 2017