Set Library List

SetLibl

The SetLibl procedure changes the library list for the current job.

The setLibl procedure can be used to change the user-portion, current, or production library list entries.

bool      SetLibl(
  InLibl          11A    Const Dim(250) 
  nLibLType       10I 0  Const Options(*NOPASS)
)

See also: ChgLibl, GetLibl, RtvLibl

Parameters

InLibl: [input Dim(250) Char(11) const] An array of library names that replace the portion of the library list identified by the nLiblType parameter.

nLiblType [optional] default=llUserLibl: [input int(4) const] An option identifier that controls which library list is changed. If unspecified, the user-portion of the jobs library list is changed. The valid options for this parameter are as follows:

Constant	Literal Value	Description
LLUSRLIBL	0	The user-portion of the job's library list.
LLCURLIB	1	The current library.
LLPRODLIBL	3	The production library or libraries.

Return Value

If the function succeeds, the return value is *ON (i.e., '1'); otherwise *OFF (i.e., '0') is returned.

If the function fails, the library list is not changed.

Remarks

The new library list must be an array of 11-positicn character fields. Up to 250 elements may be specified. To change the library list using a single, large character field, use the CHGLIBL procedure.