START—Generate an Application ID for a Services Session

The START service initializes an SCLM services session. It generates an application ID that identifies the services session. You can use the application ID to call the INIT service to initialize an SCLM ID. Each START service invocation needs a matching END service invocation.

Command invocation format

You cannot use command procedures to call this service.

Call invocation format


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

Parameters

appl_id: The generated application ID identifying the SCLM services session. Each time you invoke the START service, SCLM generates a unique application ID in this output parameter. The maximum parameter length is 8 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. See SCLM service return codes for more information.

Possible return codes are:

0: Normal completion.
12: Severe error condition. The maximum application ID limit was exceeded.
16: Severe error condition. An invalid version of the SCLM table was loaded.
20: Severe error condition. An invalid version of the multicultural support table was loaded.
24: Severe error condition. SCLM is unable to load the SCLM table.
28: Severe error condition. SCLM is unable to load the multicultural support table or the SCLM I/O load module.
32: Severe error condition. An invalid parameter list was passed to the requested service.
34: Severe error condition. An invalid service was requested.
36: Severe error condition. The version of the FLMLNK subroutine does not match the version of the SCLM services module.

Example of call invocation

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

lastrc := FLMLNK('START   ',   (* service        *)
                   appl_id);     (* application ID *)

This service call initializes an SCLM services session.