This appendix includes the following REXX functions for RIPL workstation support:

The APIs in this category provide a REXX interface that is similar to the RIPL APIs described in RIPL Category. The REXX functions reside in a DLL provided by LAN Server and are addressable from within a REXX program.

From within REXX, you also can create an addressable register function that can be called from an outside C application. This is set up from the REXX side first, by calling a routine from within a REXX function call. For example: 

call RxFuncAdd 'RxRegRIPLFuncs','RXRPLEXT','RXREGRIPLFUNCS'call RxRegRIPLFuncs
This technique can be used to make all the REXX RIPL functions addressable.

The amount of information returned depends on the value of the Level parameter passed with each function. When Level is 0 (workstation name only), each line contains the name of a single workstation. A level of 1 returns a line for each workstation beginning with the workstation name. This is followed by the delimiter pattern, ` ^ ' (space ^ space), followed by the Remark field. A similar format is used for levels 2 and 12. For example, a return from the RxNetEnumRIPLMachine function at level 0 might be: 

 
Machine1
Machine2
while the output at level 2 would appear as: 
 
Machine1 ^ remarks for 1 ^ abc123456789 f DOSIMAGE ^
                       DOS_SERV_REC_ID ^ OS2_SERV_REC_ID
Notice that only variable-length fields are separated by delimiters.

[Back] [Next]