HP 3000 Manuals HP 3000 Manuals
Chapter 8 The Session Profile What is the Session Profile? The Session Profile allows you to change the operation of the Intrinsics to suit the requirements of a calling application. This is done using a Session Profile file whose name is identified in HPDUserSignon or HPDGateSignon. Having signed on, it is also possible to switch from the current Session Profile file to another by using the HPDUtility Intrinsic. The format of the Session Profile file is similar to that of a Transaction File. A special set of transaction records have been reserved for the Session Profile, Group S in the range 100000 to 109999. As with the Transaction File, the first record in the Session Profile file must be a tt_body_type identifier that identifies the file as a Session Profile file. The Transaction File Editor allows you to create and read Session Profile files in the same way as other Transaction Files. Session Profile Records A valid profile file must contain a tt_body_type record as the first record, plus one or more of the transaction records described in the next section. If there is no Session Profile file, or records are missing from it, default settings operate for any values not supplied for the current session. The default settings are described in this chapter in the details of each individual record. Session Profile records may appear in any order in the file. No other types apart from the tt_body_type record at the beginning, Group S and Group U records should appear. Unless otherwise stated, only one Session Profile record of each type must be supplied. Every Session Profile file has a result field in bytes 9 to 12. If a Session Profile file is invalid, this result field is overwritten with an appropriate error code. Every call to HPDUserSignon, HPDGateSignon and HPDUtility has a status parameter which is a 12 byte array. status [1] identifies that an error has occurred in the Session Profile file and the subsidiary status fields (status [3] and status [4]) indicate the number of errors encountered in the file and the record number (position in the file) of the first Session Profile record in error, respectively.