Invalid Parameter when REINIT is issued.

Products

• Spool

Issue/Introduction

When trying to add a new printer using the REINIT command the following error is occurring:

REINIT  
ESF018        VPSERROR=BLANK,VPSFILE=CHAIN,VPS=VPSNNNNN 
ESF005  PARAMETER STATEMENT IS INVALID                           
ESF884  REINIT FAILED

The syntax of the printer definition is correct:

NODE PRT1,TCPIP,GROUP=300,TCPHOST=10.10.10.10,    
      VPSERROR=BLANK,VPSFILE=CHAIN,VPS=VPSNNNN   

Environment

Release : 12.0 14.0

Component : CA Spool

Cause

The group (300) used to define this printer is higher than the value of the MAXGROUP parameter.
The default value for MAXGROUP is the highest allocated group number +10.

Resolution

From documentation:

MAXGROUP=nnnnn
Description
This parameter specifies the highest network group number that can be assigned using the REINIT command.
The value must not be less than the highest allocated group number. If it is, the highest value used in any GROUP = statement in ESFPARM is used. Ensure a reasonably large number of groups is defined to minimize performance problems related to the internal structure of CA Spool. Use group numbers in strict consecutive sequence; for example, 1, 2, 3, and so on in preference to 100, 200, 300, and so on.
The lower limit is 0 and the upper limit is 99999. The default value is the highest allocated group number +10.

See that the default is the highest allocated group +10, that is, the highest group of a node that was already defined at the time CA Spool was initialized.

So, adding nodes with group values higher than MAXGROUP (or its default) requires a recycle of the CA Spool started task.