NetCOBOL V11.0 CBL Subroutines User's Guide

11.26 CBL_SET_SCR_KEYFILE

The environment of termination Key is set again according to information of the specified key definition file.

Specification

Parameter data definition

01  key-definition-file-name   PIC X(n).
01  file-name-length           PIC 9(9) BINARY.
01  status-code                PIC S9(4) COMP-5.

Calling format

CALL "CBL_SET_SCR_KEYFILE"
    USING key-definition-file-name
          file-name-length
    RETURNING status-code.

Interface

key-definition-file-name

The key definition file name is set.

file-name-length

Specifies the length of the key definition file name.

Return code

The return code is set in the status-code specified in the RETURNING clause.

status-code

• 0: Successful

• Other than 0: Failure

Note

When this routine executes, it is necessary to specify execution environment information @CBR_SCR_KEYDEFFILE beforehand.