pick_arbitrary_slot_c

	status.i4.v = pick_arbitrary_slot_c(console.i4.v, slot_type.i4.v,
					    slot.u1.r [,options.u4.v])

	This routine returns an arbitrary PA or SA process slot
	on a console.  This can be used when all slots are in use,
	and a program needs to be started.  The algorithm that it
	uses avoids the caller's slot and uses the slots in a
	rotating fashion.

	console		console number
	slot_type	type of process slot wanted
			(SLOT_TYPE_PA -> PA slot,
			 SLOT_TYPE_SA -> SA slot)
	slot		returned selected slot value
			 PA_SLOT -> primary application PA,
			 PB_SLOT -> primary application PB,
			 PC_SLOT -> primary application PC,
			 PD_SLOT -> primary application PD,
			 PE_SLOT -> primary application PE,
			 SA_SLOT -> secondary application SA,
			 SB_SLOT -> secondary application SB,
			 SC_SLOT -> secondary application SC,
			 SD_SLOT -> secondary application SD,
			 SE_SLOT -> secondary application SE)
	[options]	selection options
			(SLOT_OPT_NONE -> no options selected (default),
			 SLOT_OPT_USE_CALLER_SLOT -> include the caller's slot
						     when picking a slot,
			 SLOT_OPT_IGNORE_CONSOLE_CHANGES -> ignore console
							    argument changes
							    when picking slots)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid slot type passed

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	find_available_slot_c, slot_is_available_c, find_remote_program_slot_c,
	get_console_tasks_c, console_live_info_c

	C/C++ usage:

	unsigned char	slot;
	int	status;
	int	console = 134;
	int	slot_type = SLOT_TYPE_PA;
	unsigned int	options = SLOT_OPT_NONE;

	status = pick_arbitrary_slot_c(console,slot_type,&slot,options);