NetSetRIPLMachineInfo or Net32SetRIPLMachineInfo

The NetSetRIPLMachineInfo API changes information about a RIPL workstation.

Restrictions

Administrator authority is required for this API except when a user issues a call concerning the user

This API requires either administrator privileges or server operator privilege.

If the operating system for a workstation is to be changed, the entire level 2 structure must be used (parmnum=0).

Syntax

#include <ripl.h>
 
NetSetRIPLMachineInfo(pszServername,
          MachineName, sLevel, buf,
          usBuflen, parmnum);     /* 16 bit */
 
Net32SetRIPLMachineInfo(pszServername,
            MachineName, ulLevel, buf,
            ulBuflen, parmnum);   /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

MachineName

(unsigned char LSFAR *) points to an ASCIIZ string containing the name of the RIPL workstation definition for which information is to be changed. This pointer cannot be NULL.
sLevel or ulLevel
(16-bit short or 32-bit unsigned long) must be 1 or 2, specifying the level of detail returned in the ripl_machine_info structure as described in RIPL Machine Information Level 1 and RIPL Machine Information Level 2.
buf
(unsigned char LSFAR *) points to a ripl_machine_info structure if parmnum is 0. Otherwise, buf points to the field of the data structure that will be changed. This pointer cannot be NULL.
parmnum
(16-bit unsigned short or 32-bit unsigned long) determines whether the buffer contains a complete ripl_machine_info structure or a single field. If the value is 0, buf must contain a complete ripl_machine_info structure. Otherwise, parmnum must specify the ordinal position for a field in the data structure, defined in RIPL.H: ┌──────────────────────────────────┬───────┬───────────────────────────────────┐
│ SYMBOLIC CONSTANT │ VALUE │ DATA STRUCTURE FIELD │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_REMARK_PARMNUM │ 2 │ rmiXremark │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_ADAPTER_PARMNUM │ 3 │ rmi2_adapter_address │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_OS2_BOOTDRIVE_PARMNUM │ 5 │ rmi2_OS2_boot_drive │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_DOS_IMAGEID_PARMNUM │ 7 │ rmi2_DOS_imageid │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_DOS_SRVRECID_PARMNUM │ 9 │ rmi2_DOS_srv_rec_ID │
├──────────────────────────────────┼───────┼───────────────────────────────────┤
│ RIPL_MACH_OS2_SRVRECID_PARMNUM │ 10 │ rmi2_OS2_srv_rec_ID │
├──────────────────────────────────┴───────┴───────────────────────────────────┤
│ NOTE: X = 1 or 2. │
└──────────────────────────────────────────────────────────────────────────────┘

Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ┌─────────────────────────────┬───────┬────────────────────────────────────────┐│SYMBOLICCONSTANT │VALUE│MEANING │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NotRIPLServer │ 5401 │ The server name specified is not a │
│ │ │ valid remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RPL_MAPNotFound │ 5402 │ The RPL.MAP file was not found or │
│ │ │ could not be opened on the remote IPL │
│ │ │ server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RPL_MAPReadError │ 5403 │ An error was detected while reading │
│ │ │ the RPL.MAP file on the remote IPL │
│ │ │ server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RPL_MAPWriteError │ 5404 │ An error occurred while updating the │
│ │ │ RPL.MAP file on the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_MachineNotFound │ 5405 │ The machine definition does not exist │
│ │ │ on the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_FITSFileNotFound │ 5406 │ An error was detected while reading │
│ │ │ configuration files in the │
│ │ │ IBMLAN\RPL\FITS directory on the │
│ │ │ remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_MACHINESFileNotFound │ 5407 │ An error was detected while reading │
│ │ │ configuration files in the │
│ │ │ IBMLAN\RPL\MACHINES directory tree on │
│ │ │ the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_IBMCOMFileNotFound │ 5408 │ An error was detected while reading │
│ │ │ configuration files in the │
│ │ │ IBMLAN\RPL\IBMCOM directory tree on │
│ │ │ the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RPLUSERFileNotFound │ 5409 │ An error was detected while reading │
│ │ │ configuration files in the │
│ │ │ IBMLAN\RPLUSER directory tree on the │
│ │ │ remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RPLFileNotFound │ 5410 │ An error was detected while reading │
│ │ │ configuration files in the IBMLAN\RPL │
│ │ │ directory tree on the remote IPL │
│ │ │ server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_MachineFilesLocked │ 5411 │ Machine configuration files are locked │
│ │ │ by the remote IPL server file system. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_ServerRecordInvalid │ 5412 │ The server record identifier is not │
│ │ │ defined in an enabled server record │
│ │ │ entry in the RPL.MAP file. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RemarkInvalid │ 5413 │ The machine definition remark was more │
│ │ │ than 48 bytes. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NDISProfileNotFound │ 5414 │ The network adapter directory profile │
│ │ │ could not be found in the NDISDD.PRO │
│ │ │ file on the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_MachNameTooLong │ 5415 │ Machine definition names for DOS or │
│ │ │ FAT file systems cannot exceed 8 │
│ │ │ bytes. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachDriveInvalid │ 5424 │ The remote IPL OS/2 boot drive identi- │
│ │ │ fier is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NetworkAddressInvalid │ 5425 │ The network adapter address is not │
│ │ │ valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachAddrExists │ 5426 │ A machine definition already exists │
│ │ │ with the specified network adapter │
│ │ │ address. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachReadError │ 5428 │ An error was detected while reading │
│ │ │ machine configuration files on the │
│ │ │ remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachWriteError │ 5429 │ An error was detected while writing │
│ │ │ machine configuration files on the │
│ │ │ remote IPL server. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘
┌─────────────────────────────┬───────┬────────────────────────────────────────┐
│ SYMBOLIC CONSTANT │ VALUE │ MEANING │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachFileNotFound │ 5430 │ Files required for creating a machine │
│ │ │ definition could not be found on the │
│ │ │ remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachDirFailure │ 5432 │ An error was detected while creating │
│ │ │ machine configuration directories on │
│ │ │ the remote IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CreateMachACLFailure │ 5433 │ An error was detected while creating │
│ │ │ access control profiles on the remote │
│ │ │ IPL server. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_SetMachDriveFailure │ 5470 │ The remote IPL OS/2 boot drive identi- │
│ │ │ fier cannot be changed because the │
│ │ │ machine has a Workplace Shell desktop │
│ │ │ defined. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_SetMachNameInvalid │ 5471 │ The machine definition name cannot be │
│ │ │ changed. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_SetMachVersionInvalid │ 5472 │ The machine definition OS/2 version │
│ │ │ cannot be changed. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_SetMachCompInvalid │ 5473 │ The machine definition parameter spec- │
│ │ │ ified is not valid for the current │
│ │ │ machine definition type. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DOSImageNotFound │ 5480 │ The DOS image file name does not │
│ │ │ exist. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘


---

[Back: NetGetRIPLMachineInfo or Net32GetRIPLMachineInfo]
[Next: Serial Device Category]