INIT—Generate an SCLM ID

The INIT service initializes an SCLM ID. During this process, it also initializes the specified project definition. The INIT service also checks to make sure that the project definition is current. The project definition macros must be reassembled after installing SCLM 3.5. If the macros have not been reassembled, SCLM issues an error message. After the INIT service generates an SCLM ID, it can be passed to other SCLM services, such as DELETE and LOCK. Each INIT service invocation needs a matching FREE service invocation.

Note: SCLM maintains allocations of data sets in the hierarchy between uses of SCLM services. This enhances the performance of SCLM; however, if data sets in the hierarchy are created or deleted, the FREE service will need to be invoked to release the existing allocations and a new INIT service invoked to regain access to the project definition.

Command invocation format

You cannot use command procedures to call this service.

Call invocation format


>>-lastrc--:=--FLMLNK('INITbbbb',appl_id--,project--,prj_def---->

>--,sclm_id--,msg_line);---------------------------------------><

Parameters

appl_id: The application ID with which the generated SCLM ID is to be associated. The application ID must be generated by the START service. The maximum parameter length is 8 characters.
project: The project name. The maximum parameter length is 8 characters.
prj_def: The project definition name to be initialized for the SCLM ID. The maximum parameter length is 8 characters.
sclm_id: The generated SCLM ID. Each time you invoke the INIT service, it generates a unique SCLM ID. The maximum parameter length is 8 characters.
msg_line: An output parameter that is a buffer containing any INIT 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. See SCLM service return codes for more information.

Possible return codes are:

0: Normal completion.
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('INIT    ',       (* service                 *)
                   appl_id,        (* application ID          *)
                   'PROJ1   ',     (* project name            *)
                   'PROJ1   ',     (* project definition name *)
                   sclm_id,        (* SCLM ID                 *)
                   msg_line);      (* error messages          *)

This service call initializes an SCLM ID for the PROJ1 project using the PROJ1 project definition. The appl_id parameter contains a valid application ID returned from the START service. SCLM returns messages in the msg_line parameter.