spawn_shotlog_comment_c

	status.i4.v = spawn_shotlog_comment_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]
					      [,entry_id.i4.v]
					      [,visibility.i4.v])

	This routine will submit a comment for insertion into a web 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))
	[entry_id]	desired entry ID for appending to an existing entry
			(SL_ENTRY_ID_NONE -> make a new entry (default),
			 SL_ENTRY_ID_LAST -> append to the last entry made,
			 otherwise -> entry ID to append to)
	[visibility]	desired visibility
			(SL_VISIBILITY_NORMAL -> normal visibility (default),
			 SL_VISIBILITY_IMPORTANT -> highlighted entry)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid log type, 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_image_entry_c, spawn_shotlog_insert_url_c,
	spawn_shotlog_insert_chapter_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;
	int	entry_id = SL_ENTRY_ID_NONE;
	int	visibility = SL_VISIBILITY_NORMAL;
	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_comment_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,
					 entry_id,visibility);