Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

Attempting to update an active field that is nondynamic is essentially useless, since the active field value does not change. For instance, calling this procedure with the active_sw field set to 1 and the qti_username field populated produces no change to the system.

Setting the current_sw field to 1 causes updates to be written to the current ACMSGEN file. These updates are durable (that is, they survive a restart of the ACMS sytem) but do not affect the active system until the system is restarted.

Both current_sw and active_sw can be set on a given call. In this case, both the active and stored values for any nonnegative or nonnull fields are updated.

For any nonnegative integer fields, the completion status of the update is returned in the corresponding field in the return structure. For string fields, the string field value is returned, regardless of the status of the call.

In order to have one of the string fields set to a null string (that is, ""), populate the field with value "NULL". To have one of the string fields ignored, pass in a null string.


Example


int set_qti_data(int client_id,CLIENT *cl) 
 { 
 
   static char c_name_all[2] = "*"; 
   static char c_null_str[2] = ""; 
   static qti_config_rec set_struct; 
   static qti_status_rec *ret_struct; 
   dcl_link    *nl; 
   
   memset(&set_struct,-1,sizeof(set_struct)); 
 
   set_struct.client_id      = client_id; 
   set_struct.active_sw      = 1; 
   set_struct.current_sw     = 0; 
   set_struct.polling_timer     = 4999; 
 
   /* Have to provide a pointer for string conversions by XDR 
      or it will qtiess vio. RM will ignore any fields with 
      strlen of 0 */ 
   set_struct.qti_username = c_null_str; 
 
   ret_struct = acmsmgmt_set_qti_1(&set_struct,cl); 
 
   if (!ret_struct) { 
        printf("\n Call to modify qti failed"); 
        return(MGMT_FAIL); 
   } 
 
   if (ret_struct->status != MGMT_SUCCESS) 
      printf("\n Call to modify QTI returned the following warnings or 
errors\n"); 
   else 
      printf("\n Call to modify QTI completed\n"); 
 
   for (nl = ret_struct->qti_status_rec_u.data.cmd_output; nl != NULL; nl = 
nl->pNext) 
     printf("\n %s",nl->dcl_msg); 
 
   return(0); 
} 
      

In the preceding example, the acmsmgmt_set_qti_1 procedure is called to set the ACMSGEN parameter qti_polling_timer to 4999 milliseconds. If the call succeeds, only the active value is modified, the stored value is unchanged, and a success message is displayed. Otherwise, an error message is displayed. The example in Section 5.3.1 shows how to declare and initialize the input arguments to this procedure.

7.30 ACMSMGMT_SET_SERVER_1

This procedure modifies server (ACMS procedure server) Config class attributes.

Format

ser_status_rec *acmsmgmt_set_server_1(ser_config_rec *ser_cfg_rec,CLIENT *cl)


Parameters

ser_cfg_rec

Type: Ser_config_rec
Access: Read  
Mechanism: By reference  
Usage: Structure that contains the following client identification and Server table fields.
     
  client_id
  Type: Integer
  Access: Read
  Mechanism: By value
  Usage: If explicit authentication is being used, a valid client ID must be provided. If the value of client_id is 0, proxy access is used. Client_id is obtained by calling the acms$mgmt_get_creds procedure.
     
  appl_name
  Type: Null-terminated string
  Access: Read
  Mechanism: By reference
  Usage: Name of the application to which the server to be updated belongs.
     
  server_name
  Type: Null-terminated string
  Access: Read
  Mechanism: By reference
  Usage: Name of the server to update.
     
  creation_delay, creation_interval, deletion_delay, deletion_interval, server_proc_dmpflag, minimum_instances, maximum_instances
  Type: Integer
  Access: Read
  Mechanism: By value
  Usage: Values to be updated. These fields correspond to the active fields of the same names in the Server table (for example, creation_delay updates the creation_delay_active field). See Section 8.10 for a discussion of these fields. All fields in this record can be updated dynamically.

cl

Type: CLIENT *
Access: Read  
Mechanism: By value  
Usage: Pointer to an RPC client handle previously obtained by calling the RPC routine CLNT_CREATE.

Return Value

Type: Struct ser_status_rec
Access: Write
Mechanism: By reference
Usage: Pointer to a union. The union contains either a failure code or a structure of type ser_config_rec_out, which contains status codes for each field, as well as a linked list of status messages associated with the update. See the Description section for a discussion of how to determine the update status for any field. The following are the contents of this union:
         
  status
  Type: Integer
  Access: Write
  Mechanism: By value
  Usage: Failure return code.
         
  data, data_warn
  Type: Ser_config_rec_out
  Access: Write
  Mechanism: By value
  Usage: Structure containing fields corresponding to the fields in the ser_config_rec structure, as well as a linked list of status messages associated with the update. See the Description section for a discussion of how to determine the update status for any field. The following are the contents of this structure:
         
    creation_delay, creation_interval, deletion_delay, deletion_interval, server_proc_dmpflag, minimum_instances, maximum_instances
    Type: Integer
    Access: Write
    Mechanism: By value
    Usage: Status fields corresponding to the fields in the input argument.
         
    cmd_output
    Type: Dcl_list
    Access: Write
    Mechanism: By reference
    Usage: Pointer to a linked list of records containing status messages related to the failure of any updates. This structure contains the following fields:
         
      dcl_msg
      Type: Null-terminated string
      Access: Write
      Mechanism: By reference
      Usage: The status message.
         
      pNext
      Type: Dcl_list
      Access: Write
      Mechanism: By reference
      Usage: Pointer to the next node in the linked list.

Description

This procedure requests updates to ACMS server Config class fields contained in the Server table (see Section 8.10). Note that the Server table contains only active values.

For any nonnegative integer fields, the completion status of the update is returned in the corresponding field in the return structure.


Example


int set_ser_data(int client_id,CLIENT *cl) 
 { 
 
   static char c_name_all[2] = "*"; 
   static char vr_appl[] = "VR_APPL"; 
   static ser_config_rec set_struct; 
   static ser_status_rec *ret_struct; 
   dcl_link    *nl; 
   
   memset(&set_struct,-1,sizeof(set_struct)); 
 
   set_struct.client_id      = client_id; 
   set_struct.appl_name      = vr_appl; 
   set_struct.server_name    = c_name_all; 
   set_struct.creation_delay = 20; 
 
   ret_struct = acmsmgmt_set_server_1(&set_struct,cl); 
 
   if (!ret_struct) { 
        printf("\n Call to modify ser failed"); 
        return(MGMT_FAIL); 
   } 
 
   if (ret_struct->status != MGMT_SUCCESS) 
      printf("\n Call to modify SER returned the following warnings or 
errors\n"); 
   else 
      printf("\n Call to modify SER completed\n"); 
 
   for (nl = ret_struct->ser_status_rec_u.data.cmd_output; nl != NULL; nl = 
nl->pNext) 
     printf("\n %s",nl->dcl_msg); 
 
   return(0); 
} 
      

In the preceding example, the acmsmgmt_set_server_1 procedure is called to set the creation_delay parameter field for all servers in application VR_APPL to 20 seconds. If the call succeeds, this parameter field is modified for all servers in the VR_APPL, and a success message is displayed. Otherwise, an error message is displayed. The example in Section 5.3.1 shows how to declare and initialize the input arguments to this procedure.

7.31 ACMSMGMT_SET_TRAP_1

This procedure modifies entries in the Remote Manager Trap table. Trap table entries can also be added (see Section 7.3) and deleted (see Section 7.5).

Format

trap_status_rec *acmsmgmt_set_trap_1(trap_config_rec *trap_cfg_rec,CLIENT *cl)


Parameters

trap_cfg_rec

Type: Trap_config_rec
Access: Read  
Mechanism: By reference  
Usage: Structure that contains the following client identification and Trap table fields.
     
  client_id
  Type: Integer
  Access: Read
  Mechanism: By value
  Usage: If explicit authentication is being used, a valid client ID must be provided. If the value of client_id is 0, proxy access is used. Client_id is obtained by calling the acms$mgmt_get_creds procedure.
     
  trap_entry
  Type: Struct trap_update_rec_r
  Access: Read
  Mechanism: By value
  Usage: Structure containing a Trap table record. Trap table fields are described in Section 8.12. See the Description section for information on how to initialize this record.

cl

Type: CLIENT *
Access: Read  
Mechanism: By value  
Usage: Pointer to an RPC client handle previously obtained by calling the RPC routine CLNT_CREATE.

Return Value

Type: Struct trap_status_rec
Access: Write  
Mechanism: By reference  
Usage: Pointer to a union. The union contains either a failure code or a structure of type trap_update_rec_r, which contains status codes for each field. See the Description section for a discussion of how to determine the update status for any field. The following are the contents of this union:
     
  status
  Type: Integer
  Access: Write
  Mechanism: By value
  Usage: Failure return code.
     
  data_warn
  Type: Trap_update_rec_r
  Access: Write
  Mechanism: By value
  Usage: Structure containing a Trap table record. The entries in this field contain status codes corresponding to the fields in the trap_entry structure. See the Description section for a discussion of how to determine the update status for any field.

Description

This procedure requests updates to fields in the Trap table (see Section 8.12).

Updates to this table are not durable; that is, they do not survive a restart of the Remote Manager. To make nondynamic, permanent updates to the Trap table, use the ACMSCFG utility.

Calls to this procedure must specify entity_type, entity_name, and param_to_trap. These fields must exactly match an existing record in the Trap table for the update to be applied. Table 7-1 and Table 7-4 contain symbolic values used to populate the collection_class and entity_type fields; symbolic values to the param_to_trap field are described in Table 7-8.

Setting fields trap_min, trap_max, or severity to -2 excludes them from being updating. Otherwise, the corresponding field in the matching trap record is modified. (-1 is a special value that causes the field to be ignored when evaluating the trap conditions; see Section 6.8.)

Updates to the Trap table are processed immediately and may affect more than one ACMS process. See Section 6.8 for a discussion of how to set SNMP traps.


Example


int set_trap_data(int client_id,CLIENT *cl) 
 { 
 
   static char c_name_all[2] = "*"; 
 
   static trap_config_rec set_struct; 
   static struct trap_status_rec *status_rec; 
   
   set_struct.trap_entry.entity_type     = MGMT_ACC; 
   set_struct.trap_entry.entity_name     = c_name_all; 
   set_struct.trap_entry.param_to_trap   = MGMT_EXISTS; 
   set_struct.trap_entry.min             = 1; 
   set_struct.trap_entry.max             = -1; 
   set_struct.trap_entry.severity        = MGMT_SEV_FATAL; 
 
   status_rec = acmsmgmt_set_trap_1(&set_struct,cl); 
 
   if (!status_rec) { 
        printf("\n Call to modify trap failed"); 
        return(MGMT_FAIL); 
   } 
 
   if (status_rec->status == MGMT_WARN) { 
      printf("\nThe following updates failed: "); 
      if (status_rec->trap_status_rec_u.data_warn.entity_type  == MGMT_FAIL) 
          printf("\n     entity_type not found or invalid"); 
      if (status_rec->trap_status_rec_u.data_warn.param_to_trap == MGMT_FAIL) 
          printf("\n     param not found or invalid"); 
      if (status_rec->trap_status_rec_u.data_warn.min   == MGMT_FAIL) 
           printf("\n     min invalid"); 
      if (status_rec->trap_status_rec_u.data_warn.max   == MGMT_FAIL) 
          printf("\n     max invalid"); 
      if (status_rec->trap_status_rec_u.data_warn.severity  == MGMT_FAIL) 
          printf("\n     severity invalid"); 
     } 
   else if (status_rec->status != MGMT_SUCCESS) { 
      printf("\nCall to modify trap failed with status 
%d",status_rec->trap_status_rec_u.rc); 
      return(MGMT_FAIL); 
   } 
   else 
      printf("\nCall to modify trap was executed"); 
 
   return(0); 
} 
      

In the preceding example, the acmsmgmt_set_trap_1 procedure is called to set the trap_min field to 1, the trap_max field to -1, and the trap severity to FATAL for a trap based on an entity_type of ACC, an entity_name of * (all), and a trap parameter of EXISTS. The effect of this change is to cause a fatal-level trap to be generated if the ACC on the target node is stopped. If the call succeeds, the trap is reconfigured in the Trap table in memory. Otherwise, an error message is displayed. The example in Section 5.3.1 shows how to declare and initialize the input arguments to this procedure.


Previous Next Contents Index