spawn_shotlog_insert_chapter_c

	status.i4.v = spawn_shotlog_insert_chapter_c(log_name.i1a.r,
						     source_name.i1a.r,
						     subsource_name.i1a.r,
						     author_name.i1a.r,
						     comment.i1a.r,
						     shared_log.i1a.r
						     [,node.i4.v]
						     [,log_options.u4.v]
						     [,spawn_options.u4.v]
						     [,lock_name.i1a.r]
						     [,spawned_name.i1a.r]
						     [,message_info.s.r]
						     [,log_type.i4.v])

	This routine will insert a new chapter into the shot log.

	log_name	ASCII log name (up to SL_LOG_NAME_LEN characters)
			(If a value of NULL is passed for this argument,
			 the message will be sent to the Collider shot
			 scrapbook.)
	source_name	ASCII source name (up to SL_SOURCE_NAME_LEN characters)
	subsource_name	ASCII subsource name
			(up to SL_SUBSOURCE_NAME_LEN characters)
	author_name	ASCII author name (up to SL_AUTHOR_NAME_LEN characters)
	comment		ASCII comment string
	shared_log	shared log file to send messages to
			(LOG_NAMLEN characters)
	[node]		node to execute script on (not used)
			(default is LOCAL)
	[log_options]	unused
			(default is SL_OPT_NONE)
	[spawn_options]	spawned execution options
			(SPAWN_OPT_NONE -> no options selected,
			 SPAWN_OPT_SEND_STATUS -> send final execution
						  status to the calling program)
			(default is SPAWN_OPT_NONE)
	[lock_name]	lock to hold while the spawned process is running
			(default is NULL)
	[spawned_name]	returned name of the spawned process
			(allow PROCESS_NAME_LEN + 1 characters)
			(default is NULL)
	[message_info]	client message request information
			(structure of type SPAWNED_WEBLOG_REMOTE_MESSAGE_INFO)
			(default is NULL)
	[log_type]	log type
			(WEBLOG_LOGTYPE_OPERATIONS_CLASSIC -> original operations
							      log book,
			 WEBLOG_LOGTYPE_OPERATIONS_II -> second generation
							 operations log book,
			 WEBLOG_LOGTYPE_ECL -> log book provided by the
					       Computing Division,
			 WEBLOG_LOGTYPE_DEFAULT -> default log type (default))

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid source, subsource, or author
	CLIB_NOTOPN		failed to open file
	CLIB_GENERR		error spawning process
	otherwise		other ACNET format error code

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	spawn_shotlog_comment_c, spawn_shotlog_image_entry_c,
	spawn_shotlog_insert_url_c, shotlog_insert_window_image_c,
	shotlog_set_source_c, shotlog_set_author, spawn_acl_script_c

	C/C++ usage:

	char	*log_name = (char *) NULL;
	static const char	source_name[] = "test_stuff";
	static const char	subsource_name[] = "00";
	static const char	author_name[] = "author";
	static const char	comment[] = "a comment";
	char	spawned_name[PROCESS_NAME_LEN+1];
	char	*shared_log = (char *) NULL;
	char	*lock_name = (char *) NULL;
	int	status;
	int	node = LOCAL;
	int	log_type = WEBLOG_LOGTYPE_DEFAULT;
	unsigned int	log_options = SL_OPT_NONE;
	unsigned int	spawn_options = SPAWN_OPT_NONE;
	SPAWNED_WEBLOG_REMOTE_MESSAGE_INFO	*message_info = (SPAWNED_WEBLOG_REMOTE_MESSAGE_INFO *) NULL;

	status = spawn_shotlog_insert_chapter_c(log_name,source_name,
						subsource_name,author_name,
						comment,shared_log,node,
						log_options,spawn_options,
						lock_name,spawned_name,
						message_info,log_type);