Miscellaneous Functions

This part of the Application Programming documentation describes some miscellaneous API functions which enable the application program to utilize a wide range of features.

The functions available are described in the following table. All functions can be used in the same application program, either repeatedly or singly.

The information is organized under the following headings:

Function Description
ABEND Function Abnormally terminate with a specific termination code at a specific location within the program. A dump entry is automatically created in the Com-plete online dump file, thus enhancing program testing by providing a program image at the time of termination.
ABEXIT Function Set up routine to get control when a program abends.
CMPOST Function Signal completion of an event.
CMWAIT Function Wait on up to to eight events.
COMSTOR Functions Obtain, modify, and release storage outside of the application thread area.
DATE Function Obtain the current date in either Julian or Gregorian format.
EOJ Function Normally terminate an application program.
FREEMAIN Function Free storage in a thread.
GETCHR Function Interrogate information pertaining to the terminal in use and/or the terminal user. This information can subsequently be used to establish security for the application program or to determine various logic paths to be followed based upon desired criteria.
GETMAIN Function Acquire storage in a thread.
GETSTOR Function Acquire storage in a thread, above the 16 MB line, if available.
LEPIPI Function Call LE program from non-LE program.
MODIFY Function Modify the program environment.
RJE Function Submit job streams to the batch environment for scheduling of execution.
ROLEVT Function Rollout of the thread until an event controlled by a companion JOB (or task) occurs.
ROLOUT Function Force a scheduled rollout operation for the thread in which it is executing. The rollout operation can be used to free the thread resource.
SETEID Function Recognize the entry of the desired Program Attention keys or Program Function keys. Since Com-plete normally recognizes entry of the keys, the application program will normally not be notified of the use. The SETEID function is used to mask off from Com-plete the desired Program Attention or Program Function keys.
SNAP Function Write a thread dump without abending.
TESTAT Function Test for a desired program interrupt condition caused by pressing a Program Attention key. This function is normally used in conjunction with the ROLOUT function or the WRT function in order to enable the application program to terminate a timed rollout operation.
TIME Function Obtain information about timing intervals.