TRANSFER Reference Manual

GET-PROFILE-ELEM
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–321
GET-PROFILE-ELEM Operation
GET-PROFILE-ELEM retrieves one or more specific data elements from the Profile file.
You can use this UOW by itself or in conjunction with the ALTER-PROFILE-ELEM
UOW, which alters the data elements retrieved by GET-PROFILE-ELEM. Typically,
you retrieve the data elements with the GET-PROFILE-ELEM UOW and then modify
some or all of them with the ALTER-PROFILE-ELEM UOW.
You can use the response from GET-PROFILE-ELEM as a request to ALTER-PROFILE-
ELEM simply by changing the UOW code. These UOWs operate only on profile
records controlled by the TRANSFER delivery system; that is, those records with a
REC-TYPE value less than 1000.
Because the GET-PROFILE-ELEM and the ALTER-PROFILE-ELEM UOWs are closely
associated and because they share common fields, the operational details of both
UOWs are discussed together in the following paragraphs. The structure of the
ALTER-PROFILE-ELEM UOW, however, is presented earlier in this section.
The GET-PROFILE-ELEM and ALTER-PROFILE-ELEM UOWs retrieve and store,
respectively, information in the Profile file, according to the following rules:
The TRANSFER delivery system assumes that the names of all GUARDIAN 90
objects are entered in the US ASCII character map, even if they are entered during
a session for which the current character map is not ASCII. These names include
system, device, and file names; GUARDIAN 90 user IDs; and GUARDIAN 90
passwords. For all update operations involving these names, the TRANSFER
delivery system reads and stores the name in US ASCII form. For all retrieval
operations involving these names, the TRANSFER delivery system returns the
data for the corresponding profile element in US ASCII form.
The TRANSFER delivery system assumes that the contents of all single-character
flag fields in profile elements are in the US ASCII character map. This rule applies,
for example, to BOOLEAN fields (with content Y or N) or time-unit fields (with
content M, H, or D).
The TRANSFER delivery system maps depot passwords from native form to base
form for storage. If you enter a character that does not appear in your character
map, the TRANSFER delivery system translates this character to the same error
character in the base character set. This rule applies to most nongraphic
characters. It makes most nongraphic characters (such as control characters)
interchangeable with most other nongraphic characters in a correspondent's
password.
The TRANSFER delivery system assumes that the contents of the DATA-SYS-
FILE-VERSION element field are always entered and stored in US ASCII.
You can specify both the GET-PROFILE-ELEM and the ALTER-PROFILE-ELEM
UOWs in either of the two DDL definition formats. Both of these definitions are
discussed in the following paragraphs.