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

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

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

ulLevel

ripl_machine_info

RIPL Machine Information Level 1

RIPL Machine Information Level 2

buf

ripl_machine_info

parmnum

buf

parmnum

ripl_machine_info

buf

ripl_machine_info

parmnum

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]

[Next]