Home
Using FSS
Function Reference
SCRUPLES
#defines
3270 Attribute Chars
 
Downloads
 

FSS - TSO Full Screen Services

Function Reference

int fssInit(void)
Initialize the FSS environment and place the TSO Terminal into full screen mode. No other FSS functions may be called until fssInit() has been called.


int fssTerm(void)
Terminate the FSS environment and restore the TSO Terminal back to line mode. No other FSS functions may be called after fssTerm() has been called.


int fssReset(void)
Resets the screen environment to an empty screen. All field definitions and all data in the fields are lost.


int fssFld(int row, int col, int attr, char *fldName, int len, char *text)
Define a Dynamic Field on the current screen.
row - Row to place the field on (1-24)
col - Column to start the field in (2-79)
attr - 3270 Attribute values (basic + extended) for the field
fldName - name assigned to the field to allow access by the program interface. The field name is not displayed on the TSO Terminal.
len - the length of the field
text - initial text contents of the field


int fssTxt(int row, int col, int attr, char *text)
Add a Static field to the current screen.
row - Row to place the field on (1-24)
col - Column to start the field in (2-79)
attr - 3270 Attribute values (basic + extended) for the field
text - text contents of the field


int fssSetField(char *fldName, char *text)
Set the text contents of a field
fldName - name of the field to modify
text - text data to replace the contents of the field. If the text string is longer than the field length it will be truncated.


char * fssGetField(char *fldName)
Return a pointer to the contents of a field. A pointer to the actual field data is returned. If the string is modified, it will directly modify the field contents. Direct modification of the field contents should be avoided, fssSetField() should be used instead.


int fssGetAID(void)
Return the 3270 AID value obtained at the last terminal input operation


int fssRefresh(void)
Write the contents of the screen to the TSO Terminal and wait for input. fssRefersh() builds a 3270 data stream, writes it to the terminal with a Full-Screen TPUT and issues a TGET to wait for operator input. Modified fields are mapped back to the FSS fields.


int fssSetCursor(char *fldName)
On the next fssRefresh() call place the cursor in the specified field. The cursor location is reset after the fssRefresh() call is completed.


int fssSetAttr(char *fildName, int attr)
Set the Basic 3270 attribute of a field. Only the basic attribute value is changed. The Extended Color and Highlighting attributes are unchanged.


int fssSetColor(char *fldName, int color)
Set the extended color attribute of a field. Only the extended color attribute value is changed. The basic and extended highlighting attributes are unchanged.


int fssSetXH(char *fldName, int attr)
Set the extended highlighting attribute of a field. Only the extended highlighting attribute value is changed. The basic and extended color attributes are unchanged.



Some Handy Utility Functions

char * fssTrim(char * data)
Trim trailing blanks from a string.


int fssIsNumeric(char * data)
Return 1 if all the characters in the string are numeric digits.


int fssIsBlank(char * data)
Return 1 if all the characters in the string are blanks or the string contains no characters.


int fssIsHex(char * data)
Return 1 if all the characters in the string are numeric hex digits.