UOA:OMQUSIOB

From Remain Software
Revision as of 10:32, 3 November 2020 by Dharmveer (talk | contribs) (→‎=Process screen data)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

User Interface with Object (OMQUSIOB) - Help

User Interface with Object (OMQUSIOB)

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 own programs.

The command enables you to perform all allowed actions on an object and does so in a user-friendly manner. This command cannot be run in the background.

Action code (ACTC)

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

*ADD
Use this action code to add a new object to the TD/OMS database.
*CHANGE
Use this action code to change one or more object attributes.
*CLOSE
Use this action code to close the object database and to perform the last record processing. This option enables you to leave the interface to the fix database open until you explicitly close it. This will make the interface faster.
*COPY
Use this action code to copy the attributes of an object as a base for another object. Several object dependent attributes cannot be copied but are retrieved from the object's object description.
*DELETE
Use this action code to remove an object from the database.
*DISPLAY
Use this action code to display the description of an object. No change actions are allowed.

Function key definition (FUNKEY)

This User Interface API enables you to create your own function key definitions. With this feature, you are able to customize the API and create a seamless interface to the TD/OMS database. If a user presses one of the user-defined function keys, a diagnostic message will be sent back to the caller stating the function key which was pressed. You are able to receive this message and have your programs act upon it. The possible values are:

*DFT
Use the default function keys.
*USER
Indicates that you supply one or more function keys to the user interface. If this value is used, you will be prompted for the function keys you wish to supply.

Function keys (USERKEYS)

This User Interface API enables you to create your own function key definitions. With this feature, you are able to customize the API and create a seamless interface to the TD/OMS database. If a user presses one of the user-defined function keys, a diagnostic message will be sent back to the caller stating the function key which was pressed. You are able to receive this message and have your programs act upon it. The possible values are:

*DFT
Use the default function keys.
*USER
Indicates that you supply one or more function keys to the user interface. If this value is used, you will be prompted for the function keys you wish to supply.

Function keys (USERKEYS)

Specify the function keys you wish to activate. The function keys you specify are placed at the bottom of the screen. If more function key text is provided than can be placed on the line, TD/OMS activates the F24=More keys function key which will toggle the display of other function keys.

Function key F1 cannot be supplied because it is engraved to trigger the display of help texts. For CUA compliance, TD/OMS will automatically supply the following default function keys:

F1 This key will always be used to trigger help.
F3 Exits the display without updating the database.
F4 This key will first be used to prompt the fields determined by the function. If the cursor is not a promptable field and it is assigned by the user then it is returned to the caller.
F5 This will be the refresh key.
F8 This will show the object's OS/400 description.
F12 Cancel the input without updating the database.
F24 If the program detects more function keys than will fit on one line, the user-supplied F24 key will be replaced by the F24=More standard key.

The function keys F1, F3, F4, F5, F8, and F12 will be added to the area for a user-defined function key area if they are not supplied. Function keys F1 and F4 do not show text in the area but they are active.

You should be careful about using these function keys because they are normally used for other purposes.

Function key number

Specify the number of the function key. This should be a numerical value in the range of 2 to 24.

Process screen data

Use this element to specify if the data already entered by the user should be processed when the function key is pressed. The possible values are:

*NO
The data in the display will not be processed if the function key is pressed. Possible conflicts that were keyed after the last use of the enter key will not be signaled.
*YES
The data in the display will be processed before the function returns to the calling program. The database will be updated and the function returns if no errors are found. If errors are found they will be displayed and the
function will not return until either all the errors are solved or an exit key is pressed.

Message identifier

Use this element in combination with the message file qualifier to specify the message which contains the function key description. Only the first 30 positions of the first level message text are retrieved. The possible values are:

*NONE
The text is not stored in a message. The text is instead retrieved from the function key text element.
message-identifier
Specify the message which holds the description of the function key. Only the first 30 positions of the first level text of the message are placed in the function key area.

Message file

If the message identifier is specified, the message file and library must also be specified. The possible values are:

OMSDSP
This message file is used by TD/OMS to store language-independent texts. You can use this to retrieve texts which are already defined. Do not add new message id's to this message file because it will be replaced when a new release is installed.
message-file
Specify the message file.

Message file library

*LIBL
All the libraries in the user and system's portion of the library are searched to locate the message file.
library
Specify the library of the message file.

Function key text

Specify the function key text. The text should preferably be in the format Fnn=tttt where nn is the function key number and tttt is the description of the function key. The text may not exceed 30 characters in length. The possible values are:

*BLANK
The contents of the message identifier is used to describe the function key. The literal *BLANK will be displayed in the function key area if no message identifier is specified.
function-key-description
Specify the description of the function key.

Object class (OCLS)

Specify the class of the object. The class is always determined by TD/OMS unless the object is temporary. The possible values are:

*OS400
The object is an OS/400 object.
*GL4
The object is an object from a fourth-generation language.
*HFSOBJ
The object is an object from a hierarchical file system. This can be a PC object or a document from an AS/400 folder.

Temporary or virtual object (EXCI)

Specify whether the object is a virtual or temporary object or if it is a real object. The possible values are:

*NO
The object is not temporary or virtual. TD/OMS can expect to find the object in the indicated location. If the object cannot be found in this location an error is reported.
*YES
The object is virtual or temporary. A temporary object can be a work file to which programs relate but only exists during the duration of a job. Virtual objects are mostly used to represent a real object like a printer or a terminal.

Close API (CLOSE)

Specify if the API must close all files and free storage upon completion of the requested action. The possible values are:

*YES
The files are closed and storage is freed by the API upon completion of the requested action. Subsequent actions must re-open the necessary files and programs.
*NO
The state of the API was left when the requested action was completed. Files remain open and relationship updates are postponed. Subsequent calls to the API are considerably faster and storage is not freed.

Fast re-display (REDISPLAY)

Use this element to specify if the API must perform a fast re-display. This option will only have an effect if it is used in combination with CLOSE(*NO). The possible values are:

*NO
Do not use a fast re-display. Open the program normally and perform function key determination, authorization checking, and buffer filling.
*YES
Use a fast re-display. When this option is used, the function keys area is not changed, most buffer fill requests are skipped and the authorization checks are also skipped. This value is only meaningful if the function was called before with CLOSE(*NO). A normal display will be performed if the interface to the database is not yet open.

Protect application (PRAPPL)

The protect application element is used to prevent the user from changing the contents of the application field. The possible values are:

*NO
The application code of the display is not protected. You can enter an application code in the display of the function.
*YES
The application field of the functions display is not accessible for input. Use this value to make sure that the application code is not changed by the user. This value is useful only in combination with a pre-filled application code.

Protect environment (PRENVC)

The protect environment element is used to prevent the user from changing the contents of the environment field. The possible values are:

*NO
The environment code of the display is not protected. You can enter an environment code in the display of the function.
*YES
The environment field of the functions display is not accessible for input. Use this value to make sure that the environment code is not changed by the user. This value is useful only in combination with a pre-filled
environment code.

Pre-fill fields (PREFILL)

Specify if fields have to be loaded with (initial) values before they are displayed on the screen. This element is useful only when the action is *ADD (*COPY) or *CHANGE. The possible values are:

*NO
No values are pre-filled with the supplied data. All fields are loaded with initial values if the action is add. The fields are loaded with the values from the database if the action is change.
*YES
The fields on the display are first filled with the values from the database (if any) and then overwritten with the user-supplied values (if any). Output only fields cannot be overwritten in change mode.
*FIELD
Specifies that the field in the cursor field is supplied by the user and other values are either initialized (when adding) or filled with the database value (when changing).

Cursor field (CRSFIELD)

Specify the field which must be pre-filled before it is displayed. This element is useful only when the action is *ADD (*COPY) or *CHANGE. The possible values are:

APPL Application code
ENVC Environment
OBJC Object code
OBJL Object library
OBJT Object type
OBJA Object attribute
OBJD Object description
SRCF Source file
SRCL Source library
SRCM Source member
FIX Fix number

Key (KEY)

Specify the key to the object if one is required by the selected action.

Object code

Specify the name of the object.

Object library

Specify the location of the object.

Object type

Specify the type of the object.

Application (APPL)

Specify the application which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*APPL
The current active application code is used. An error is reported if no application is currently active.
application-code
Specify the application code.

Environment (ENVC)

Specify the environment which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information.

Object code (OBJC)

Specify the object code which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information.

Object type (OBJT)

Specify the object type which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information.

Object attribute (OBJA)

Specify the attribute which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*OBJD
Use the attribute from the actual object. This value is not allowed for temporary or virtual objects.
object-attribute
Specify the attribute

Object description (OBJD)

Specify the description which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*OBJD
Use the description from the actual object. This value is not allowed for temporary or virtual objects.
object-description
Specify the description of the object.

Source file (SRCF)

Specify the source file which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*OBJD
Use the source file from the actual object. This value is not allowed for temporary or virtual objects.
source file
Specify the source file of the object.
*BEST
Search the environment definitions for the best source library.
source-library
Specify the source library.

Source member (SRCM)

Specify the source member which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*OBJD
Use the member from the actual object. This value is not allowed for temporary or virtual objects.
source-member
Specify the source member of the object.

Created by (OCRT)

Specify the user who must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*OBJD
Use the user from the actual object. This value is not allowed for temporary or virtual objects.
user ID.
Specify the user who created the object.

Fix number (FIX)

Specify the fix number which must be used to pre-fill the field in the display of the function. Consult the pre-fill help texts for more information. The possible values are:

*ACTIVE
The solution database is searched for the current active fix number.
*NONE
The fix number in the object is not filled.
fix-number
Specify the fix number which caused the fix to be created into this library.