#include <stdio.h>
#include <stdlib.h>

Data Structures
struct	EnVarList

struct	DiaChr

Macros
#define	CLEP_DEFAULT_CCSID_ASCII 819

#define	CLEP_DEFAULT_CCSID_EBCDIC 1047

#define	SAFE_FREE(x) do { if ((x) != NULL) {free((void*)(x)); (x)=NULL;} } while(0)

#define	GETENV(name) getenv((name))

#define	SETENV(name, value) setenv((name), (value), 1)

#define	UNSETENV(name) unsetenv((name))

#define	isStr(c) (isprint(c) \|\| (c)==C_TLD \|\| (c)==C_DLR \|\| (c)==C_ATS \|\| (c)==C_BSL \|\| (c)==C_CRT \|\| (c)==C_EXC)

#define	isKyw(c) (isalnum(c) \|\| (c)=='_')

#define	isCon(c) (isKyw(c) \|\| (c)=='-' \|\| (c)=='/')

#define	ISDDNAME(p) (strlen(p)>3 && toupper((p)[0])=='D' && toupper((p)[1])=='D' && (p)[2]==':')

#define	ISPATHNAME(p) (strchr((p),'/')!=NULL)

#define	ISDSNAME(p) (strlen(p)>2 && toupper((p)[0])=='/' && toupper((p)[1])=='/')

#define	ISGDGMBR(m) ((m)[0]=='0' \|\| (m)[0]=='+' \|\| (m)[0]=='-')

#define	ISDDN(c) (isalnum(c) \|\| (c)==C_DLR \|\| (c)==C_HSH \|\| (c)==C_ATS)

#define	fopen_tmp() tmpfile()

#define	fclose_tmp(fp) fclose((fp))

#define	remove_hfq(n) remove(n)

#define	CLERTC_OK 0

#define	CLERTC_INF 1

#define	CLERTC_FIN 2

#define	CLERTC_WRN 4

#define	CLERTC_RUN 8

#define	CLERTC_MAP 12

#define	CLERTC_SYN 16

#define	CLERTC_CMD 20

#define	CLERTC_INI 24

#define	CLERTC_CFG 28

#define	CLERTC_TAB 32

#define	CLERTC_SYS 36

#define	CLERTC_ACS 40

#define	CLERTC_ITF 44

#define	CLERTC_MEM 48

#define	CLERTC_FAT 64

#define	CLERTC_MAX 64

#define	strncpy(...) Error: Do not use strncpy! Use strlcpy instead!

#define	CSTIME_BUFSIZ 24

#define	HSH_PBRK "#" /nodiac/

#define	ATS_PBRK "@" /nodiac/

#define	C_EXC '!' /nodiac/

#define	C_HSH '#' /nodiac/

#define	C_DLR '$' /nodiac/

#define	C_ATS '@' /nodiac/

#define	C_SBO '[' /nodiac/

#define	C_BSL '\\' /nodiac/

#define	C_SBC ']' /nodiac/

#define	C_CRT '^' /nodiac/

#define	C_GRV '`' /nodiac/

#define	C_CBO '{' /nodiac/

#define	C_VBR '\|' /nodiac/

#define	C_CBC '}' /nodiac/

#define	C_TLD '~' /nodiac/

#define	S_EXC "!" /nodiac/

#define	S_HSH "#" /nodiac/

#define	S_DLR "$" /nodiac/

#define	S_ATS "@" /nodiac/

#define	S_SBO "[" /nodiac/

#define	S_BSL "\\" /nodiac/

#define	S_SBC "]" /nodiac/

#define	S_CRT "^" /nodiac/

#define	S_GRV "`" /nodiac/

#define	S_CBO "{" /nodiac/

#define	S_VBR "\|" /nodiac/

#define	S_CBC "}" /nodiac/

#define	S_TLD "~" /nodiac/

#define	S_SVB "=\|" /nodiac/

#define	S_SBS "/\\" /nodiac/

#define	S_IDT "--\|" /nodiac/

#define	esrprintc srprintc

#define	esnprintf snprintf

#define	esprintf sprintf

#define	efprintf fprintf

Typedefs
typedef struct EnVarList	TsEnVarList

typedef struct DiaChr	TsDiaChr

Functions
FILE *	fopen_hfq (const char name, const char mode)

FILE *	fopen_hfq_nowarn (const char name, const char mode)

FILE *	freopen_hfq (const char name, const char mode, FILE *stream)

long long	getFileSize (const char *name)

char *	userid (const int size, char *buffer)

char *	homedir (const int flag, const int size, char *buffer)

char *	duserid (void)

char *	dhomedir (const int flag)

char *	safe_getenv (const char name, char buffer, size_t bufsiz)

char *	unEscape (const char input, char output)

char *	dynUnEscape (const char *input)

int	printd (const char *format,...) __PRINTF_CHECK__(1

int int	snprintc (char buffer, const size_t size, const char format,...) __PRINTF_CHECK__(3

int int int	srprintc (char *buffer, size_t size, const size_t expansion, const char *format,...) __PRINTF_CHECK__(4

int int int int	srprintf (char *buffer, size_t size, const size_t expansion, const char *format,...) __PRINTF_CHECK__(4

int int int int void	fprintm (FILE file, const char own, const char pgm, const char bld, const char *man, const int cnt)

int	snprintm (char buffer, size_t size, const char own, const char pgm, const char bld, const char *man, const int cnt)

const char *	prsdstr (const char *hdl, const char str, int len)

size_t	strlcpy (char dest, const char src, size_t n)

char *	getenvar (const char name, const size_t length, const size_t size, char string)

char *	mapstr (char *string, int size)

char *	dmapstr (const char *string, int method)

char *	dmapxml (const char *string, int method)

char *	mapfil (char *file, int size)

char *	dmapfil (const char *file, int method)

char *	maplab (char *label, int size, int toUpper)

char *	dmaplab (const char *label, int method)

char *	cpmapfil (char dest, int size, const char source)

char *	dcpmapfil (const char *file)

char *	cpmaplab (char label, int size, const char templ, const char *values, int toUpper)

char *	dcpmaplab (const char templ, const char values, int method)

unsigned int	localccsid (void)

const char *	mapl2c (unsigned isEBCDIC)

const char *	lng2ccsd (const char *pcLang, unsigned isEbcdic)

const char *	mapccsid (const unsigned int uiCcsId)

unsigned int	mapcdstr (const char *p)

unsigned int	bin2hex (const unsigned char bin, char hex, const unsigned int len)

unsigned int	hex2bin (const char hex, unsigned char bin, const unsigned int len)

unsigned int	chr2asc (const char chr, char asc, const unsigned int len)

unsigned int	chr2ebc (const char chr, char ebc, const unsigned int len)

unsigned int	asc2chr (const char asc, char chr, const unsigned int len)

void	asc_chr (const char asc, char chr, const unsigned int len)

void	chr_asc (const char chr, char asc, const unsigned int len)

unsigned int	ebc2chr (const char ebc, char chr, const unsigned int len)

void	ebc_chr (const char ebc, char chr, const unsigned int len)

void	chr_ebc (const char chr, char ebc, const unsigned int len)

int	file2str (void hdl, const char filename, char *buf, int bufsize, char *errmsg, const int msgsiz)

int	arry2str (char array[], const int count, const char separ, const int separLen, char *out, int outlen)

int	strxcmp (const int ca, const char s1, const char s2, const int n, const int c, const int f)

char *	cstime (signed long long t, char *p)

int	loadEnvars (const unsigned int uiLen, const char pcBuf, FILE pfOut, FILE pfErr, TsEnVarList *ppList)

int	readEnvars (const char pcFil, FILE pfOut, FILE pfErr, TsEnVarList *ppList)

int	envarInsert (TsEnVarList *ppList, const char pcName, const char *pcValue)

int	resetEnvars (TsEnVarList **ppList)

void	init_diachr (TsDiaChr *psDiaChr, const unsigned int uiCcsId)

Macro Definition Documentation

◆ CLEP_DEFAULT_CCSID_ASCII

#define CLEP_DEFAULT_CCSID_ASCII 819

◆ CLEP_DEFAULT_CCSID_EBCDIC

#define CLEP_DEFAULT_CCSID_EBCDIC 1047

◆ SAFE_FREE

#define SAFE_FREE ( x ) do { if ((x) != NULL) {free((void*)(x)); (x)=NULL;} } while(0)

Free memory space

◆ GETENV

#define GETENV ( name ) getenv((name))

◆ SETENV

#define SETENV	(	name,
		value
	)	setenv((name), (value), 1)

◆ UNSETENV

#define UNSETENV ( name ) unsetenv((name))

◆ isStr

#define isStr ( c ) (isprint(c) || (c)==C_TLD || (c)==C_DLR || (c)==C_ATS || (c)==C_BSL || (c)==C_CRT || (c)==C_EXC)

◆ isKyw

#define isKyw ( c ) (isalnum(c) || (c)=='_')

◆ isCon

#define isCon ( c ) (isKyw(c) || (c)=='-' || (c)=='/')

◆ ISDDNAME

#define ISDDNAME ( p ) (strlen(p)>3 && toupper((p)[0])=='D' && toupper((p)[1])=='D' && (p)[2]==':')

◆ ISPATHNAME

#define ISPATHNAME ( p ) (strchr((p),'/')!=NULL)

◆ ISDSNAME

#define ISDSNAME ( p ) (strlen(p)>2 && toupper((p)[0])=='/' && toupper((p)[1])=='/')

◆ ISGDGMBR

#define ISGDGMBR ( m ) ((m)[0]=='0' || (m)[0]=='+' || (m)[0]=='-')

◆ ISDDN

#define ISDDN ( c ) (isalnum(c) || (c)==C_DLR || (c)==C_HSH || (c)==C_ATS)

◆ fopen_tmp

#define fopen_tmp ( ) tmpfile()

◆ fclose_tmp

#define fclose_tmp ( fp ) fclose((fp))

◆ remove_hfq

#define remove_hfq ( n ) remove(n)

◆ CLERTC_OK

#define CLERTC_OK 0

0 - command line, command syntax, mapping, execution and finish of the command was successful

◆ CLERTC_INF

#define CLERTC_INF 1

1 - command line, command syntax, mapping, execution and finish of the command was successful but a warning can be found in the log

◆ CLERTC_FIN

#define CLERTC_FIN 2

2 - command line, command syntax, mapping, execution was successful but cleanup of the command failed (may not happened)

◆ CLERTC_WRN

#define CLERTC_WRN 4

4 - command line, command syntax and mapping was successful but execution of the command returns with a warning

◆ CLERTC_RUN

#define CLERTC_RUN 8

8 - command line, command syntax and mapping was successful but execution of the command returns with an error

◆ CLERTC_MAP

#define CLERTC_MAP 12

12 - command line and command syntax was OK but mapping failed

◆ CLERTC_SYN

#define CLERTC_SYN 16

16 - command line was OK but command syntax was wrong

◆ CLERTC_CMD

#define CLERTC_CMD 20

20 - command line was wrong (user error)

◆ CLERTC_INI

#define CLERTC_INI 24

24 - initialization of parameter structure for the command failed (may not happened)

◆ CLERTC_CFG

#define CLERTC_CFG 28

28 - configuration is wrong (user error)

◆ CLERTC_TAB

#define CLERTC_TAB 32

32 - table error (something within the predefined tables is wrong)

◆ CLERTC_SYS

#define CLERTC_SYS 36

36 - system error (mainly memory allocation or some thing like this failed)

◆ CLERTC_ACS

#define CLERTC_ACS 40

40 - access control or license error

◆ CLERTC_ITF

#define CLERTC_ITF 44

44 - interface error (parameter pointer equals to NULL or something like this)

◆ CLERTC_MEM

#define CLERTC_MEM 48

48 - memory allocation failed (e.g. dynamic string handling)

◆ CLERTC_FAT

#define CLERTC_FAT 64

64 - fatal error (basic things are damaged)

◆ CLERTC_MAX

#define CLERTC_MAX 64

maximal condition code value (greater condition codes are special return codes)

◆ strncpy

#define strncpy ( ... ) Error: Do not use strncpy! Use strlcpy instead!

◆ CSTIME_BUFSIZ

#define CSTIME_BUFSIZ 24

Build time string

Convert a time integer to a 20 byte time string of form YYYY-MM-DD HH:MM:SS.

Parameters

[in]	t	time in seconds since 1970 or 0 for current time
[in]	p	NULL to return a static variable or a pointer where the 20 bytes are copied in

Returns: pointer to the time string

◆ HSH_PBRK

#define HSH_PBRK "#" /*nodiac*/

◆ ATS_PBRK

#define ATS_PBRK "@" /*nodiac*/

◆ C_EXC

#define C_EXC '!' /*nodiac*/

◆ C_HSH

#define C_HSH '#' /*nodiac*/

◆ C_DLR

#define C_DLR '$' /*nodiac*/

◆ C_ATS

#define C_ATS '@' /*nodiac*/

◆ C_SBO

#define C_SBO '[' /*nodiac*/

◆ C_BSL

#define C_BSL '\\' /*nodiac*/

◆ C_SBC

#define C_SBC ']' /*nodiac*/

◆ C_CRT

#define C_CRT '^' /*nodiac*/

◆ C_GRV

#define C_GRV '`' /*nodiac*/

◆ C_CBO

#define C_CBO '{' /*nodiac*/

◆ C_VBR

#define C_VBR '|' /*nodiac*/

◆ C_CBC

#define C_CBC '}' /*nodiac*/

◆ C_TLD

#define C_TLD '~' /*nodiac*/

◆ S_EXC

#define S_EXC "!" /*nodiac*/

◆ S_HSH

#define S_HSH "#" /*nodiac*/

◆ S_DLR

#define S_DLR "$" /*nodiac*/

◆ S_ATS

#define S_ATS "@" /*nodiac*/

◆ S_SBO

#define S_SBO "[" /*nodiac*/

◆ S_BSL

#define S_BSL "\\" /*nodiac*/

◆ S_SBC

#define S_SBC "]" /*nodiac*/

◆ S_CRT

#define S_CRT "^" /*nodiac*/

◆ S_GRV

#define S_GRV "`" /*nodiac*/

◆ S_CBO

#define S_CBO "{" /*nodiac*/

◆ S_VBR

#define S_VBR "|" /*nodiac*/

◆ S_CBC

#define S_CBC "}" /*nodiac*/

◆ S_TLD

#define S_TLD "~" /*nodiac*/

◆ S_SVB

#define S_SVB "=|" /*nodiac*/

◆ S_SBS

#define S_SBS "/\\" /*nodiac*/

◆ S_IDT

#define S_IDT "--|" /*nodiac*/

◆ esrprintc

#define esrprintc srprintc

◆ esnprintf

#define esnprintf snprintf

◆ esprintf

#define esprintf sprintf

◆ efprintf

#define efprintf fprintf

Typedef Documentation

◆ TsEnVarList

typedef struct EnVarList TsEnVarList

◆ TsDiaChr

typedef struct DiaChr TsDiaChr

Function Documentation

◆ fopen_hfq()

FILE* fopen_hfq	(	const char *	name,
		const char *	mode
	)

◆ fopen_hfq_nowarn()

FILE* fopen_hfq_nowarn	(	const char *	name,
		const char *	mode
	)

◆ freopen_hfq()

FILE* freopen_hfq	(	const char *	name,
		const char *	mode,
		FILE *	stream
	)

◆ getFileSize()

long long getFileSize ( const char * name )

◆ userid()

char* userid	(	const int	size,
		char *	buffer
	)

Returns the current user id.

Parameters

size	size of the buffer
buffer	pointer to the buffer

Returns: pointer to the buffer containing the current user id (null-terminated)

◆ homedir()

char* homedir	(	const int	flag,
		const int	size,
		char *	buffer
	)

Returns the current home directory.

Parameters

flag	if true then slash/backslash are added
size	size of the string buffer
buffer	pointer to the buffer

Returns: pointer to the buffer containing the current home directory (null-terminated)

◆ duserid()

char* duserid ( void )

Returns the current user id.

Returns: pointer to the buffer containing the current user id (null-terminated) must be freed by the caller

◆ dhomedir()

char* dhomedir ( const int flag )

Returns the current home directory.

Parameters

flag	if true then slash/backslash are added

Returns: pointer to the buffer containing the current home directory (null-terminated) must be freed by the caller

◆ safe_getenv()

char* safe_getenv	(	const char *	name,
		char *	buffer,
		size_t	bufsiz
	)

Gets an environment variable and stores it in the provided buffer. If the buffer is not large enough, the variable value is truncated.

Parameters

name	Name of the environment variable
buffer	Pointer to the buffer for the variable value
bufsiz	Size of the buffer

Returns: If bufsiz > 0, returns the buffer pointer which contains a null-terminated string or NULL (variable does not exist). If bufsiz == 0, buffer is returned unmodified.

◆ unEscape()

char* unEscape	(	const char *	input,
		char *	output
	)

Un-escape a string as part of special character support in EBCDIC codepages (static version).

Parameters

input	pointer to the input string containing the escape sequences
output	pointer to the output string for un-escaping (could be equal to the input pointer)

Returns: pointer to the un-escaped output or NULL if error

◆ dynUnEscape()

char* dynUnEscape ( const char * input )

Un-escape a string as part of special character support in EBCDIC codepages (dynamic version).

Parameters

input pointer to the input string containing the escape sequences

Returns: pointer to the un-escaped output or NULL if error (calling application must free the memory)

◆ printd()

int printd	(	const char *	format,
			...
	)

Works like printf but print only in debug mode.

Parameters

format format string

Returns: amount of characters printed (0 are mainly a error)

◆ snprintc()

int int snprintc	(	char *	buffer,
		const size_t	size,
		const char *	format,
			...
	)

Works like snprintf but concatenates the format string to the buffer.

Parameters

buffer	pointer to the string buffer
size	size of the string buffer
format	format string

Returns: amount of characters printed (0 are mainly a error)

◆ srprintc()

int int int srprintc	(	char **	buffer,
		size_t *	size,
		const size_t	expansion,
		const char *	format,
			...
	)

Works like snprintf but does reallocation of the buffer (maximal expansion of the format string can be specified).

Parameters

buffer	pointer to pointer to the string buffer (is updated, could be NULL at beginning)
size	pointer to size of the string buffer (is updated, could be 0 at beginning)
expansion	maximal expected expansion of the format string (size must be fit strlen(*buffer)+strlen(format)+expansion+1)
format	format string

Returns: amount of characters printed (0 are mainly a error)

◆ srprintf()

int int int int srprintf	(	char **	buffer,
		size_t *	size,
		const size_t	expansion,
		const char *	format,
			...
	)

Works like snprintc but does reallocation of the buffer (maximal expansion of the format string can be specified).

Parameters

buffer	pointer to pointer to the string buffer (is updated, could be NULL at beginning)
size	pointer to size of the string buffer (is updated, could be 0 at beginning)
expansion	maximal expected expansion of the format string (size must be fit strlen(format)+expansion+1)
format	format string

Returns: amount of characters printed (0 are mainly a error)

◆ fprintm()

int int int int void fprintm	(	FILE *	file,
		const char *	own,
		const char *	pgm,
		const char *	bld,
		const char *	man,
		const int	cnt
	)

Prints man pages to a file, inserting owner, program name, build number, state and date into placeholders

Parameters

file	pointer to the file
own	owner name for replacement (&{OWN})
pgm	program name for replacement (&{PGM})
bld	build/version string for replacement (&{BLD})
man	manpage to print, which can contain &{PGM}, &{OWN}, &{BLD}, &{DATE} and &{STATE}
cnt	amount of ' ' added to man page (0,1,2 (>2=2))

◆ snprintm()

int snprintm	(	char *	buffer,
		size_t	size,
		const char *	own,
		const char *	pgm,
		const char *	bld,
		const char *	man,
		const int	cnt
	)

Prints man pages to a buffer, inserting owner, program name, build number, state and date into placeholders

Parameters

buffer	pointer to the buffer
size	size of the buffer
own	owner name for replacement (&{OWN})
pgm	program name for replacement (&{PGM})
bld	build/version string for replacement (&{BLD})
man	manpage to print, which can contain &{PGM}, &{OWN}, &{BLD}, &{DATE} and &{STATE}
cnt	amount of ' ' added to man page (0,1,2 (>2=2))

Returns: same as snprintf

◆ prsdstr()

const char* prsdstr	(	const char **	hdl,
		const char *	str,
		int	len
	)

This function parses a zero terminated string array of a certain length or terminated with 0xFF. Such a string array is the result of a variable length array of strings provided by CLP. If you don't know the length, please provide a negative number to look for 0xFF termination. For 0xFF termination you must define the CLPFLG_DLM. This is useful if there is no capability to use the ELN link to determine the length of the string array. Each call returns the pointer to the next string in the array, if no string is found anymore NULL is returned.

Parameters

hdl	pointer of pointer to string initialized with NULL at beginning
str	pointer to the string arrays from CLP
len	-1 for 0xFF delimiter parsing or the ELN of the string array

Returns: pointer to one string or NULL if no more string

◆ strlcpy()

size_t strlcpy	(	char *	dest,
		const char *	src,
		size_t	n
	)

Works like strncpy but ensures null-termination.

Parameters

dest	pointer to destination string
src	pointer to source string
n	size of memory available for buffer

Returns: number of bytes actually copied (excludes NUL-termination)

◆ getenvar()

char* getenvar	(	const char *	name,
		const size_t	length,
		const size_t	size,
		char *	string
	)

Get environment variable and handle HOME, USER, CUSEr, Cuser, cuser, OWNER, ENVID if not defined

Parameters

name	environment variable name
length	optional length of the name if no zero termination (0 if zero termination)
size	size of string
string	containing the value for the corresponding environment variable

Returns: pointer to string

◆ mapstr()

char* mapstr	(	char *	string,
		int	size
	)

Replace all environment variables enclosed with '<' and '>' to build a string

Parameters

string	string for replacement
size	size of replacement string

Returns: pointer to string

◆ dmapstr()

char* dmapstr	(	const char *	string,
		int	method
	)

Replace all environment variables enclosed with '<' and '>' to build a dynamic string

Parameters

string	string for replacement
method	conversion method (1 - to upper, 2 - to lower, else nothing)

Returns: pointer to the new allocated string or NULL if error

◆ dmapxml()

char* dmapxml	(	const char *	string,
		int	method
	)

Replace all environment variables enclosed with '(' and ')' to build a dynamic string

Parameters

string	string for replacement
method	conversion method (1 - to upper, 2 - to lower, else nothing)

Returns: pointer to the new allocated string or NULL if error

◆ mapfil()

char* mapfil	(	char *	file,
		int	size
	)

Replace '~' with "<HOME>" and all environment variables enclosed with '<' and '>' to build a file name

Parameters

file	string for replacement
size	size of replacement string

Returns: pointer to file

◆ dmapfil()

char* dmapfil	(	const char *	file,
		int	method
	)

Replace '~' with "<HOME>" and all environment variables enclosed with '<' and '>' to build a dynamic file name

Parameters

file	string for replacement
method	conversion method (1 - to upper, 2 - to lower, else nothing)

Returns: pointer to the new allocated string or NULL if error

◆ maplab()

char* maplab	(	char *	label,
		int	size,
		int	toUpper
	)

Replace '!' with ENVID, '~' with "<SYSUID>", '^' with "<OWNERID>" and all environment variables enclosed with '<' and '> to build a key label'

Parameters

label	string for replacement
size	size of replacement string
toUpper	for mapping file to upper

Returns: pointer to label

◆ dmaplab()

char* dmaplab	(	const char *	label,
		int	method
	)

Replace '!' with ENVID, '~' with "<SYSUID>", '^' with "<OWNERID>" and all environment variables enclosed with '<' and '> to build a dynamic key label'

Parameters

label	string for replacement
method	conversion method (1 - to upper, 2 - to lower, else nothing)

Returns: pointer to new allocated string or NULL if error

◆ cpmapfil()

char* cpmapfil	(	char *	dest,
		int	size,
		const char *	source
	)

Replace '~' with "<HOME>" and all environment variables enclosed with '<' and '>'

Parameters

dest	string for replacement
size	size of replacement string
source	original string

Returns: pointer to dest

◆ dcpmapfil()

char* dcpmapfil ( const char * file )

Replace '~' with "<HOME>" and all environment variables enclosed with '<' and '>' and returns a dynamic string

Parameters

file	string for replacement

Returns: pointer to dynamic allocated string

◆ cpmaplab()

char* cpmaplab	(	char *	label,
		int	size,
		const char *	templ,
		const char *	values,
		int	toUpper
	)

Use rpltpl() and maplab() to build key label names, based on key label templates

Parameters

label	string for replacement
size	size of replacement string
templ	key label template (with x)
values	value string for replacement (x:s )
toUpper	for mapping label to upper

Returns: pointer to label

◆ dcpmaplab()

char* dcpmaplab	(	const char *	templ,
		const char *	values,
		int	method
	)

Use drpltpl() and dmaplab() to build key label names, based on key label templates in dynamic form

Parameters

templ	key label template (with x)
values	value string for replacement (x:s )
method	conversion method (1 - to upper, 2 - to lower, else nothing)

Returns: pointer to dynamic allocated string

◆ localccsid()

unsigned int localccsid ( void )

Determines the local CCSID by querying nl_langinfo() (POSIX) or GetCPInfoEx() (Windows). If none of both are available or no valid CCSID can be determined, mapl2c() is called. If it also fails to determine the system default CSSID, the CCSID for ASCII (ISO8859-1) or IBM-1047 (EBCDIC platforms) is returned.

Returns: A supported CCSID > 0

◆ mapl2c()

const char* mapl2c ( unsigned isEBCDIC )

Map environment variable LANG to CCSID

Parameters

isEBCDIC if true returns EBCDIC code pages else ASCII

Returns: NULL in case of an error or pointer to a static string containing the CCSID

◆ lng2ccsd()

const char* lng2ccsd	(	const char *	pcLang,
		unsigned	isEbcdic
	)

Map environment variable LANG to CCSID

Parameters

pcLang	string containing the value of the environment variable LANG
isEbcdic	if true returns EBCDIC code pages else ASCII

Returns: NULL in case of an error or pointer to a static string containing the CCSID

◆ mapccsid()

const char* mapccsid ( const unsigned int uiCcsId )

Map CCSID in encoding string

Parameters

uiCcsId CCSID

Returns: encoding string

◆ mapcdstr()

unsigned int mapcdstr ( const char * p )

Map encoding string in CCSID

Parameters

p	encoding string

Returns: CCSID

◆ bin2hex()

unsigned int bin2hex	(	const unsigned char *	bin,
		char *	hex,
		const unsigned int	len
	)

Convert binary to hex

Parameters

bin	binary blob
hex	hex string
len	length of binary blob

Returns: amount of converted bytes

◆ hex2bin()

unsigned int hex2bin	(	const char *	hex,
		unsigned char *	bin,
		const unsigned int	len
	)

Convert from hex to binary

Parameters

hex	hex string
bin	binary string
len	length of hex string

Returns: amount of converted bytes

◆ chr2asc()

unsigned int chr2asc	(	const char *	chr,
		char *	asc,
		const unsigned int	len
	)

Convert character string to US-ASCII(UTF-8) and stops at not convertible chars

Parameters

chr	character string
asc	ASCII string
len	length

Returns: amount of converted bytes

◆ chr2ebc()

unsigned int chr2ebc	(	const char *	chr,
		char *	ebc,
		const unsigned int	len
	)

Convert character string to EBCDIC (only non variant characters) and stops at not convertible chars

Parameters

chr	character string
ebc	EBCDIC string
len	length

Returns: amount of converted bytes

◆ asc2chr()

unsigned int asc2chr	(	const char *	asc,
		char *	chr,
		const unsigned int	len
	)

Convert ASCII to character string (only non variant characters) and stops at not convertible chars

Parameters

asc	ASCII string
chr	character string
len	length

Returns: amount of converted bytes

◆ asc_chr()

void asc_chr	(	const char *	asc,
		char *	chr,
		const unsigned int	len
	)

Convert ASCII to character string (only non variant characters) and replace not convertible chars with '_'

Parameters

asc	ASCII string
chr	character string
len	length

◆ chr_asc()

void chr_asc	(	const char *	chr,
		char *	asc,
		const unsigned int	len
	)

Convert character string to US-ASCII(UTF-8) and replace not convertible chars with '_'

Parameters

chr	character string
asc	ASCII string
len	length

◆ ebc2chr()

unsigned int ebc2chr	(	const char *	ebc,
		char *	chr,
		const unsigned int	len
	)

Convert EBCDIC to character string (only non variant characters) and stops at not convertible chars

Parameters

ebc	EBCDIC string
chr	character string
len	length

Returns: amount of converted bytes

◆ ebc_chr()

void ebc_chr	(	const char *	ebc,
		char *	chr,
		const unsigned int	len
	)

Convert EBCDIC to character string (only non variant characters) and replace not convertible chars with '_'

Parameters

ebc	EBCDIC string
chr	character string
len	length

◆ chr_ebc()

void chr_ebc	(	const char *	chr,
		char *	ebc,
		const unsigned int	len
	)

Convert character string to EBCDIC (only non variant characters) and replace not convertible chars with '_'

Parameters

chr	character string
ebc	EBCDIC string
len	length

◆ file2str()

int file2str	(	void *	hdl,
		const char *	filename,
		char **	buf,
		int *	bufsize,
		char *	errmsg,
		const int	msgsiz
	)

Read a file using the specified filename and reads the whole content into the supplied buffer. The buffer is reallocated and bufsize updated, if necessary.

This is the default implementation if no file to string function for CLEP provided

Parameters

hdl	is ignored and not used (required for default implementation of call back function)
filename	The path and name of the file to read
buf	A pointer to a pointer to a buffer, may be a pointer to NULL for allocation else reallocation
bufsize	A pointer to the size of buf, is updated ater the call
errmsg	Pointer to a provided buffer for the error message (optional (can be NULL), result is null terminated)
msgsiz	The size of the buffer for the error message (optional (can be 0))

Returns

A positive value indicates the number of bytes read and copied into buf. A negative value indicates an error, in which case the content of buf is undefined. Error codes:

-1: invalid arguments
-2: fopen() failed
-3: integer overflow, file too big
-4: realloc() failed
-5: file read error

◆ arry2str()

int arry2str	(	char *	array[],
		const int	count,
		const char *	separ,
		const int	separLen,
		char **	out,
		int *	outlen
	)

Takes an array of null-terminated strings and concatenates all strings into one single string separated by the specified separator. The resulting string is put into the out buffer which may be reallocated if necessary. If the buffer already contain a string the remaining strings are concatenated.

Parameters

array	Input array of null-terminated strings.
count	Number of string in array
separ	Separator of arbitrary length (may be NULL if separLen=0)
separLen	length of separator
out	Pointer to an output buffer (may be reallocated)
outlen	Size of output buffer

Returns

Error codes:

0: success
-1: invalid arguments
-2: realloc() failed

◆ strxcmp()

int strxcmp	(	const int	ca,
		const char *	s1,
		const char *	s2,
		const int	n,
		const int	c,
		const int	f
	)

Compare of two string

The procedure combines strcmp, stricmp, strncmp and strchr in one function.

Parameters

[in]	ca	Flag if case sensitiv (TRUE) or not (FALSE)
[in]	s1	String 1 to compare
[in]	s2	string 2 to compare
[in]	n	If c!=0 then minimum else maximum amount of character to compare (0=disabled)
[in]	c	Character where the compare stops or -1 for keyword syntax
[in]	f	If true only compare up to null termination or stop char if false (normal compare) including null termination or stop char

Returns: signed integer with 0 for equal and !=0 for different

◆ cstime()

char* cstime	(	signed long long	t,
		char *	p
	)

◆ loadEnvars()

int loadEnvars	(	const unsigned int	uiLen,
		const char *	pcBuf,
		FILE *	pfOut,
		FILE *	pfErr,
		TsEnVarList **	ppList
	)

Load environment variables from buffer

Parameters

[in]	uiLen	Length of the buffer with environment variables
[in]	pcBuf	Buffer containing list of environment variables (ASCII or EBCDIC separated by new line or semicolon)
[in]	pfOut	File pointer for output messages
[in]	pfErr	File pointer for error messages
[out]	ppList	Pointer to an optional envar list for reset (the list and each string must freed by caller)

Returns: >=0 amount of successful defined environment variables else -1*CLERTCs

◆ readEnvars()

int readEnvars	(	const char *	pcFil,
		FILE *	pfOut,
		FILE *	pfErr,
		TsEnVarList **	ppList
	)

Read and set environment variables from file

Parameters

[in]	pcFil	Filename, if pcFil==NULL use "DD:STDENV" instead
[in]	pfOut	File pointer for output messages
[in]	pfErr	File pointer for error messages
[out]	ppList	Pointer to an optional envar list for reset (the list and each string must freed by caller)

Returns: >=0 amount of successful defined environment variables else -1*CLERTCs

◆ envarInsert()

int envarInsert	(	TsEnVarList **	ppList,
		const char *	pcName,
		const char *	pcValue
	)

Store envars in a list for reset

Parameters

[out]	ppList	Pointer to envar list for reset
[in]	pcName	Name of the environment variable
[in]	pcValue	Value of the environment variable (NULL for unset)

◆ resetEnvars()

int resetEnvars ( TsEnVarList ** ppList )

Reset list of environment variables

Parameters

[in] ppList Pointer to envar lisl

Returns: amount of envars reset or -1*CLERTCs

◆ init_diachr()

void init_diachr	(	TsDiaChr *	psDiaChr,
		const unsigned int	uiCcsId
	)

Data Structures

Macros

Typedefs

Functions

Macro Definition Documentation

◆ CLEP_DEFAULT_CCSID_ASCII

◆ CLEP_DEFAULT_CCSID_EBCDIC

◆ SAFE_FREE

◆ GETENV

◆ SETENV

◆ UNSETENV

◆ isStr

◆ isKyw

◆ isCon

◆ ISDDNAME

◆ ISPATHNAME

◆ ISDSNAME

◆ ISGDGMBR

◆ ISDDN

◆ fopen_tmp

◆ fclose_tmp

◆ remove_hfq

◆ CLERTC_OK

◆ CLERTC_INF

◆ CLERTC_FIN

◆ CLERTC_WRN

◆ CLERTC_RUN

◆ CLERTC_MAP

◆ CLERTC_SYN

◆ CLERTC_CMD

◆ CLERTC_INI

◆ CLERTC_CFG

◆ CLERTC_TAB

◆ CLERTC_SYS

◆ CLERTC_ACS

◆ CLERTC_ITF

◆ CLERTC_MEM

◆ CLERTC_FAT

◆ CLERTC_MAX

◆ strncpy

◆ CSTIME_BUFSIZ

◆ HSH_PBRK

◆ ATS_PBRK

◆ C_EXC

◆ C_HSH

◆ C_DLR

◆ C_ATS

◆ C_SBO

◆ C_BSL

◆ C_SBC

◆ C_CRT

◆ C_GRV

◆ C_CBO

◆ C_VBR

◆ C_CBC

◆ C_TLD

◆ S_EXC

◆ S_HSH

◆ S_DLR

◆ S_ATS

◆ S_SBO

◆ S_BSL

◆ S_SBC

◆ S_CRT

◆ S_GRV

◆ S_CBO

◆ S_VBR

◆ S_CBC

◆ S_TLD

◆ S_SVB

◆ S_SBS

◆ S_IDT

◆ esrprintc

◆ esnprintf

◆ esprintf

◆ efprintf

Typedef Documentation

◆ TsEnVarList

◆ TsDiaChr

Function Documentation