9.109 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

2