9.129 GET_SESSION_VALUE
Returns the value for a specified X_RUN parameter.
The following parameters are supported :
APPL, ASCT, ASLU, ASPW, ASSQ, ASST, ASTC, CDLL, CIPH, CMTH, DBID, DBUS, DBUT, DBII, DBIT, DELI, DPTH, EXPS, GUSR, HELP, HLPF, HMJB, INST, ITRO, ITRL, ITRM, ITRC, LANG, ODBI, PKGD, PPTH, PSCT, PSTC, PSLU, PSST, PSPW, QUET, RPTH, SUBD, UDEF, USER, USEX, WDTM plus all Windows Printing Extension parameters such as WPEN, WPPN, WPPS, WPPD, WPDF, WPDS, WPFO, WPAS, XCMD (only becomes active for jobs submitted after it has been set).
LOB Temporary File Parameters
The following pseudo X_RUN parameters are supported for LOB temporary file handling. They return directories that can be used in code to temporarily store LOB files for the current job or user. Use the OV_FILE_SERVICE Built-In Function to ensure the directory exists before creating files:
|
LTPP
|
Temporary LOB Path for the current job. Automatically cleaned up when LANSA completes execution.
|
|
LTPU
|
Temporary LOB Path for the current user. Not cleaned up when LANSA completes execution.
|
|
Pseudo X_RUN parameters are supported by Visual LANSA for Windows only:
|
*ENC
|
Encoded root path. Returns an alphanumeric string that matches the Windows registry key for the currently executing application.
|
|
*HST
|
Returns the Host Monitor status (the meaning of the return values is not currently published).
|
|
*LPC
|
Returns 'Y' if the LANSA development environment is running. Otherwise returns 'N'.
|
|
*MEX
|
Returns the maximum export version that can be imported into the system, as 3 characters with a leading zero. For example, '001'.
|
|
For use with
|
LANSA for i
|
YES
|
Only available for RDMLX.
|
|
Visual LANSA for Windows
|
YES
|
|
|
Visual LANSA for Linux
|
YES
|
|
|
Arguments
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
X_RUN Parameter Name
Note: USER vs USEX
USER always uses value in upper case
USEX maintains case exactly as entered. For example:
If AbCd is entered, USER = ABCD
USEX = AbCd
|
1
|
4
|
|
|
|
Return Values
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
X_RUN Parameter Value
|
1
|
256
|
|
|
|
2
|
A
|
Req
|
Return Code
OK = Parameter Returned OK
ER = Error returning value
|
2
|
2
|
|
|
|