9.108 GET_SESSION_VALUE

Note: Built-In Function Rules Usage Options

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'.

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

Content

Space Tools

9.108 GET_SESSION_VALUE