UOA:OMQCHGSL

From Remain Software
(Redirected from UOA:OMQCHGSL)
Jump to navigation Jump to search
Translate this page

Change Sub-Environment Library API (OMQCHGSL) - Help

Change Sub-Environment Library API (OMQCHGSL)

This Application Program Interface command allows you to manipulate the TD/OMS database. This can be done from a command line or from within your programs.

The command enables you to perform all allowed actions on a sub-environment library. You can use this command to add, update, copy, and delete the library.

Action code (ACTC)

Specify the action to be performed. The possible values are:

*ADD
Use this action code to add the sub-environment library.
*CHANGE
Use this action code to change the sub-environment library.
*COPY
Use this action code to copy the sub-environment library.
*DELETE
Use this action code to remove the sub-environment library.

Application code (APPC)

Specify the application code. See the description of the application code for more information.

Environment code (PDLC)

Specify the environment code. See the description of the environment code for more information.

Sub-environment sequence (SEQN)

Specify the Sub-environment sequence. See the description of the sub-environment sequence for more information.

Library Sequence (LSEQN)

Specify the Library sequence. See the description of the library sequence for more information.

*NEXT
Use this value to allocate the next available sequence number for the library. This value can be used with action code *ADD only. For other action codes enter the number yourself.

Library (LIB)

The library name is an OS/400 system library or it can be defined as a logical library for describing folder and 4GL model storage information. Libraries are checked for existence if the library list type has a value of "0" or "1". Refer to the functions Folder library definition and 4GL library definition for more detailed information about logical library names.

To Library Sequence Number (TLSEQN)

Use this prompt to enter the to library sequence number. This prompt is available when the action code is *COPY or *CHANGE. By using this prompt user can change the existing sequence number to a new sequence number which is valid. Also, the user can copy a library to a new sequence number.

*NEXT
Use this value to allocate the next available sequence number for the to-library.

This value can be used with action code *copy only. *Next will allocate the next available sequence number to the library which will be created during copy operation.

Catch all library (LIBC)

A library with the catch all indicator specified indicates that the library is the default library to be used. Objects with an unspecified object type are placed in this library. The order of specifying the catch all library is of no importance.

If no catch all library is defined in a sub-environment, only objects with the specified types are created in that sub-environment.

*SAME
Use this value to indicate that the Catch all library does not change if you are in change mode. and If you are in add mode It contains the default value. The default value for the check source location is '*NO'.
*YES
It sets the value as '1' for Catch all library.
*NO
It sets the value as '0' for Catch all library.

Source library indicator (LIBS)

The Source library indicator is used to define a specific library that the library also contains sources. All source libraries are checked in the Fill Object File function, in order of appearance.

The definition of source libraries is also used during Object Transfer to decide where source members have to be stored. If an object is placed in a library which is also defined as a source library, the related source of that object is placed in that library. If an object is placed in a library that is not defined as a source library, the first source library (if any) in that library list will be used.

Refer to the Source handling concepts for more detailed information.

*SAME
Use this value to indicate that the source library does not change if you are in change mode. and If you are in add mode It contains the default value. The default value for the source library is '*NO'.
*YES
It sets the value as '1' for the source library.
*NO
It sets the value as '0' for the source library.

Keep library (KEEP)

The Keep library indicator is used for a specific library to indicate that objects are not being removed by TD/OMS if a move operation is executed during Object Transfer. This is useful for libraries containing database objects, because the data in those files should be kept for testing purposes. 

Note:  A keep library will keep the objects during Object Transfer. A related source member however will always be removed after a move action. Use an exception if you also want to retain the source.
*SAME
Use this value to indicate that the keep library does not change if you are in change mode. and If you are in add mode It contains the default value. The default value for the keep library is '*NO'.
*YES
It sets the value as '1' for keep library.
*NO
It sets the value as '0' for keep library.

Relation search library (LIBR)

The relation search library indicator is used for defining a library which is not owned by the application you are defining it for, but that is to be used for searching for a related object in other applications. A library with this indicator specified, cannot have any other indicator specified.

If, for example, some of your objects are using objects from the QSYS library, define the QSYS library with the search indicator, so it is not part of this application but TD/OMS will check the QSYS library when relations of objects are being built. 

NOTE: A search library does not have to be defined in each sub-environment.  You only need to define search libraries in the production environment because TD/OMS is checking all higher environments for related objects.
*SAME
Use this value to indicate that the relation search library does not change if you are in change mode. and If you are in add mode It contains the default value. The default value for the relation search library is '*NO'.
*YES
It sets the value as '1' for the relation search library.
*NO
It sets the value as '0' for the relation search library.

Create directory (CLIB)

The create library parameter is used to create the specified library. The possible values are:

*YES
The library will not be created.
*NO
If the specified library does not exist, it will be created at run time.

Library Details

The library details contain the library description and the name of the library from where OMSREFOBJ will be copied.

Library description
If default value *CALC is used, description will be prepared automatically by the system, else user can give custom description. Description can not exceed length 50.
Copy OMSREFOBJ from
Specify the name of the library from where OMSREFOBJ has to be copied. If special value *NONE is used, OMSREFOBJ will not be copied to the newly created library.

Object Type & Attributes (OBJTA)

The Object Type & Attribute contains Object Type and Attributes. See the description of the object type and object attribute for more information.

*NONE
Use this value when you don't want to pass object type and attributes.

If you pass *NONE with action code *ADD, it will not add the type and attributes to the library you are trying to create. You can leave this field blanks as well if you don't want to pass any type and attributes.

If you pass *NONE with action code *CHANGE, it will not retain the type and attributes from the library you are trying to change.

If you pass *NONE with action code *COPY, it will not copy the type and attributes from the library you are trying to copy.