MAXCURS (JANUS DEFINE parameter)

<section begin="desc" />MAXCURS xxx -- max number of cursors allowed for a single SDS connection.<section end="desc" />

MAXCURS is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.

This parameter specifies the maximum number of cursors that can be opened for a single Janus Specialty Data Store connection. The default for MAXCURS is 5.

A Sybase Adaptive Server or Omni SQL Server will open multiple cursors on a connection to an SDS thread. Typically, even for fairly complex requests the number of simultaneously open cursors will not exceed 3 so that the default of 5 should be fine. If a Sybase Adaptive Server attempts to open more cursors than is allowed by MAXCURS, the request will fail.

The cost of having a high MAXCURS is the storage for each possible cursor is allocated either at port start time for each thread or at connection time for ALLOCC ports. The storage required for each cursor is about 64 bytes so that on a 40 thread port with MAXCURS set to 5, the virtual storage used for cursor blocks would be 64*5*40 or 12,800 bytes.

Valid only for SDS (also known as OMNI and OAS) ports.

References

See: List of Janus commands | List of JANUS DEFINE parameters.