END— End an SCLM Services Session

The END service stops an SCLM services session. It frees an application ID generated by the START service. Each START service invocation needs a matching END service invocation. This service also calls the FREE service to free any SCLM IDs associated with the given application ID that have not been explicitly freed.

Command invocation format

You cannot use command procedures to call this service.

Call invocation format


>>-lastrc--:=--FLMLNK('ENDbbbbb',appl_id,msg_line);------------><

Parameters

appl_id: The application ID associated with the SCLM services session you want to stop. You must generate the application ID using the START service. The maximum parameter length is 8 characters.
msg_line: An output parameter that has a buffer containing any END service error message. The maximum parameter length is 80 characters.

Return codes

Additional special services messages are written to the FLMMSGS ddname. See SCLM service messages for more information.

Other return codes might be produced by the FLMLNK processor.

Possible return codes are:

0: Normal completion.
4: Warning condition. SCLM cannot free an SCLM ID associated with the application ID.
8: Error condition. See the msg_line parameter description for more details.

Example of call invocation

This example shows general syntax. Call invocations are language-specific. See Sample programs using SCLM services for specific examples.

lastrc := FLMLNK('END     ',          (* service        *)
                   appl_id,           (* application ID *)
                   msg_line);         (* error messages *)

This service call ends the SCLM services session identified by the appl_id parameter. The appl_id parameter contains a valid application ID returned from the START service. SCLM returns messages in the msg_line parameter.